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About This Manual 


Who should use this manual... 

This guide is intended for the System/3 6 work station operator who will be using 
the Multiple Session Remote Job Entry (MSRJE) feature and for the System/36 
programmer responsible for configuring System/36 for MSRJE. 

This guide should also be useful to the programmer who is responsible for adding 
System/3 6 into the host system network as a remote job entry (RJE) work station. 

Using this guide, the operator can: 

• Sign on a display station to MSRJE as a reader 

• Sign on a display station to MSRJE as the MSRJE console 

• Enter MSRJE utility control statements to control an MSRJE session 

• End an MSRJE session 

• Use the MSRJE disk file utility to print data that was written to disk, or to 
convert punch data from a compressed file to a data file 

Using this guide, the System/36 programmer can: 

• Configure System/3 6 to use MSRJE 

• Write the MSRJE utility control statements to control an MSRJE session 

• Generate forms control table entries to control the destination of output 
received from the host system 

Using this guide, the host system programmer can: 

• If needed, modify host system programs that support RJE to support 
System/36 MSRJE 

• Generate the host system communications network to include System/36 as an 
RJE work station 
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How this manual is arranged ... 

Chapter 1 introduces the concept of remote job entry and provides an overview of 
the support provided by MSRJE. 

Chapter 2 describes how the MSRJE environment is defined. 

Chapter 3 provides the information necessary to run MSRJE, and describes how 
input to MSRJE and output from MSRJE are handled. 

Chapter 4 describes the MSRJE utility control statements that are used to control 
an MSRJE session. 

Chapter 5 describes the use of the MSRJE forms control table utility. 

Chapter 6 describes the MSRJE disk file utility. 

Chapter 7 discusses the aspects of the BSC host system generation applicable to 
System/36. 

Chapter 8 discusses the aspects of the SNA host system generation applicable to 
System/36. 

Appendix A contains work sheets that can be used to obtain information from or 
give information to the persons responsible for defining System/36 to a host 
system. 

Appendix B defines the format of the SNA bind command that System/36 must 
receive before SNA MSRJE can be run. 

Appendix C provides an example of an MSRJE session, including the configuration, 
utility control statements and host system JCL. 

Appendix D shows the default values provided by IBM for use in forms control 
tables. 

Appendix E provides an example of the work sheets that should be filled out to tell 
the operator how to establish the data link on a switched line. 

Appendix F contains a problem determination procedure that can help you find the 
cause of an MSRJE problem. 

The Glossary defines the data processing, data communications, and System/36 
terms used in this manual. 
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What you should know 


The reader is assumed to have read the following manual or have the equivalent 
knowledge: 

• IBM System/36 Learning About Your Computer , SC21-9018 

The System/3 6 work station operator is expected to be familiar with the operation 
of a System/36 Work Station, and the System/36 programmer is expected to be 
familiar with configuring System/36 for communications. 


If you need more information ... 

The IBM publications listed here provide additional information about topics 
described or referred to in this guide. 

System/36 Publications 

• Operating Your Computer , SC21-9026 

• System Problem Determination , SC21-7919 for the 5360 System Unit, or 
SC21-9063 for the 5362 System Unit 

• System Reference , SC21-9020 

| • System Messages , SC21-7938 

• Multiple Session Remote Job Entry Messages , SC21-7944 

• Interactive Communications Feature: Reference , SC21-7910 

• Interactive Communications Feature: Guide and Examples , SC21-7911 

• Communications and Systems Management Guide , SC21-8010 

• Concepts and Programmer's Guide , SC21-9019 

• System Security Guide , SC21-9042 

• Changing Your System Configuration , SC21-9052 

• Converting from System/34 to System/36, SC21-9053 

| • Using System/36 Communications , SC21-9082 
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General Communications 


• Data Communications Concepts , GC21-5169 

Data Link Control 

• IBM Synchronous Data Link Control General Information , GA27-3093 

• General Information—Binary Synchronous Communications , GA27-3004 

Systems Network Architecture (SNA) 

• Systems Network Architecture Reference Summary , GA27-3136 

• Systems Network Architecture Introduction , GA27-3116 

• Systems Network Architecture Concepts and Products , GC30-3072 

• Systems Network Architecture General Information , GA27-3102 

• Systems Network Architecture Format and Protocol Reference Manual: 
Architectural Logic , SC30-3112 

• Systems Network Architecture-Sessions Between Logical Units , GC20-1868 

Communications Controllers 

• IBM 3704 and 3705 Program Reference Handbook , GY30-3012 

• Guide to Using the IBM 3 704 Communications Controller Control Panel , 
GA27-3086 

• Guide to Using the IBM 3 705 Communications Controller Control Panel , 
GA27-3087 

• IBM 3704 and 3705 Control Program Generation and Utilities Guide and 
Reference Manual , GC30-3008 

• Introduction to the IBM 3704 and 3705 Communications Controllers , 
GA27-3051 

• 3725 Model 1 Communication Controller, Introduction , GA33-0010 

• 3725 Model 2 Communication Controller, Introduction , GA33-0021 

• 3725 Communication Controller, Principles of Operation , GA33-0013 
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VTAM 


I 


Advanced Communications Function for VTAM (ACF/VTAM) General 
Information , GC3 8-0254 

Introduction to VTAM (Virtual Telecommunications Access Method)> GC27-6987 
VTAM Concepts and Planning , GC27-6998 

Advanced Communications Function for VTAM (ACF/VTAM) System 
Programmer’s Guide , SC38-0258 


Job Entry Subsystems (JES) 


OS/VS2 JES2 

• OS/VS2 MVS System Programming Library: Initialization and Tuning , 
SC23-0046 

• OS/VS 2 MVS / System Product Version 1 General Information Manual , 
GC28-1025 

• Operator’s Library OS/VS2 Remote Terminals (JES2), GC38-0225 

• Operator’s Library: JES2 Commands , SC23-0048 

| • OS/VS2 MVS System Programming Library: JES2, GC23-0002 

OS/VS2 JES3 

• Introduction to JES3, GC28-0607 

• OS/VS2 MVS System Programming Library: JES3, GC28-0608 

• OS/VS 2 MVS System Programming Library: JES 3 Debugging Guide , 
GC28-0703 

• Operator’s Library: OS/VS2 MVS JES3 Commands , GC23-0008 

• Operator’s Library: OS/VS2 Remote Terminals (JES3), GC38-0228 

| • OS/VS2 MVS System Programming Library: JES 5, GC28-0608 

OS/VS1 RES 

• OS/VS1 RES System Programmers Guide , GC28-6878 

• OS/VS l RES Workstation User’s Guide , GC28-6879 

• OS/VS1 Information Distribution Workstation Support General Information , 
GC24-5193 
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VM/370 RSCS 


• Virtual Machine Facility/370: Remote Spooling Communications Subsystem 
(RSCS) User’s Guide , GC20-1801 

• IBM Virtual Machine Facility/370: Introduction , GC20-1800 

• IBM Virtual Machine Facility/370: System Programmer’s Guide , GC20-1807 

• IBM Virtual Machine Facility/3 70: Remote Spooling Communications 
Subsystem (RSCS) User’s Guide , GC20-1816 

VSE/POWER with RJE Feature Operating Under DOS/VSE 

• VSE/POWER General Information Manual , GH12-5128 

• VSE/POWER Installation and Operations Guide , SH12-5329 
. VSE/POWER Specifications , GH12-5046 

• VSE/POWER RJE Users Guide , SH12-5328 

How this manual has changed ... 

The following are major changes made to this manual since the previous edition: 

• Throughout the manual, information about the number of communications 
lines available has been updated to eight. 

• Information showing that more than one location can be specified to run more 
than one remote location on a single line. 

• Information about defining line members has been removed from Chapter 2. 
This information is now included in the manual, Using System/36 
Communications. 

• The descriptions and some of the command keys used on many of the MSRJE 
displays are different. 

• MSRJE now supports up to 198 print positions if you are using a printer that 
supports 15 characters per inch. 

• In Chapter 4, a new utility control statement (INFOMSG) has been added. 

• In Chapter 5: 

— You now have the option to print a control table. 

— You can update compressed disk file parameters that are present in the 
control table entry. 


Xll Multiple Session Remote Job Entry Guide 




Chapter 1. Introducing Multiple Session Remote Job Entry 


The System/36 Multiple Session Remote Job Entry (MSRJE) feature allows you to 
submit jobs from System/36 to a host system for processing and to obtain the 
output of those jobs from the host system. MSRJE allows you to use the 
processing power of a host system, and yet maintain your own local applications on 
System/36. To use MSRJE, System/36 must be attached to the host system using 
a data link. With MSRJE, System/36 can communicate with either BSC (binary 
synchronous communications) or SNA (systems network architecture) host 
systems. 


What Is Remote Job Entry? 

Host system sites generally consist of a large computer (such as an IBM 
System/370, IBM 303x System, or an IBM 43xx Processor) with several input and 
output devices. Usually, the input devices are display stations, card readers, disk 
units, tape units, and the system console. The output devices are display stations, 
card punches, disk units, tape units, the system console and printers. Data to be 
processed by the computer is entered through one of the input devices, the 
computer processes the data, and the results of the processing are directed to one 
or more of the output devices. 

Traditionally, computer input has been in the form of punched cards. These cards 
are punched on a keypunch machine by an operator who uses source documents, 
such as orders or invoices, as input. The punched cards are then read into the 
computer by a card reader. Once the computer completes the processing of the 
data, it generates output in the form of printed reports or punched cards. The 
punched cards generated as output are then either manually stored in a card file or 
used as input to another computer job. 

As companies with this type of installation grew, much of the input to the system 
came from remote locations, such as branch offices or regional warehouses. These 
remote locations generally mailed their source documents to the central site, where 
it was transferred to cards by a keypunch machine operator. The punched cards 
were then read into the computer from a card reader; the computer processed the 
data and generated output in the form of printed reports and punched cards. Any 
of the output required by the remote location was then mailed to the location. As 
information needs grew, it became increasingly obvious that a more timely method 
of submitting data to the computer and receiving output at the remote locations 
was required. The concept of remote job entry grew out of this need for more 
rapid turnaround of jobs processed by the computer. 
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Remote job entry uses a card reader, card punch, and printer at the remote 
locations. These devices are attached to a control unit, which is attached to the 
central site computer through a data link. A keypunch machine is also placed at the 
remote site so that source documents can be transferred to punched cards at the 
remote site. Once the data link is established, the user can enter the host system 
commands and data from the card reader and receive the output from the host 
system at the printer or card punch. The remote location control unit and its 
attached devices are referred to as a remote job entry (RJE) work station. 

Figure 1-1 illustrates the relationships between the central site computer, its local 
devices, and the RJE work station. 

Host Input Devices Host Output Devices 



Figure 1-1. Overview of RJE Relationship to the Host System 
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Any job that can be entered directly into the host system from its local input 
devices can also be entered from an RJE work station. When a job is submitted 
from an RJE work station, it is processed by the host system in the same manner as 
any locally submitted job. When the job has completed processing, the output can 
be returned to the RJE work station, directed to another RJE work station, or 
directed to one of the output devices locally attached to the host system. 


Terms Related to Remote Job Entry 

Before you continue reading about System/36 MSRJE, there are several terms 

whose meanings you should know. You will frequently come across these terms in 

this guide and in other readings about remote job entry. 

• Job Control Language (JCL). All jobs submitted to the host system must 
contain job control language (JCL) statements to tell the host system what to 
do. JCL is the host system’s version of the System/36 Operator Control 
Language (OCL). JCL statements tell the host system what application 
program to start when the job is submitted from the RJE work station, where 
the output is to go, and also tells the host system how much of the computer 
resources (such as disk and main storage) are required by the job. 

• Data stream. A data stream is a group of records that relates to either an input 
or output device, or a group of records that relates to an input or output 
function. For example, data that is being sent to the host system is called a 
reader data stream because it will be viewed by the host system as card reader 
input. Print data that is received from the host system is called a print data 
stream; punch data received from the host system is called a punch data 
stream. 

• Host commands. These are commands sent by the RJE work station that tell 
the host system to do something, such as start a print output task or cancel a 
print task. 

• Session. (1) The logical connection by which programs or devices can 
communicate with each other. (2) The length of time that starts when an 
operator signs on to the system and ends when the operator signs off the 
system. 
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System/36 as a Remote Job Entry Work Station 


With the MSRJE feature, you can use System/36 as an RJE work station. Because 
System/36 does not support cards, the card reader input stream comes from either 
disk or from a display station keyboard. Before sending data to the host system, 
MSRJE ensures that, whether the data comes from a display station keyboard or 
disk, it will be acceptable to the host system as reader input. 

Display station input is much the same as card input because the input source 
documents are entered from a keyboard and converted to a format that can be read 
by the computer. However, instead of generating punched cards as a keypunch 
machine does, System/36 either stores the entered data in a disk file (that file can 
then become reader input to MSRJE) or submits the data directly to MSRJE, 
which then sends the data to the host system. 

When a punch data stream is received from the host system, MSRJE stores that 
data in a disk file. The disk file can then be used as input to another job (either a 
local System/36 job or an RJE job). 

When print data is received from the host system, MSRJE either prints it as it is 
received or writes it to a disk file for later printing by the MSRJE disk file utility 
(you control the destination of output received by MSRJE, as described in 
Chapter 3). 

In addition to transmitting data, MSRJE can also send Job Control Language 
(JCL) statements and commands to the host system. JCL and host system 
commands are not checked by MSRJE; they are simply sent. You must ensure the 
accuracy of JCL and host system commands before using them with MSRJE. 

MSRJE utility control statements control the operation of MSRJE. These 
statements are processed by MSRJE and are not sent to the host system. The 
MSRJE utility control statements are described in Chapter 4. 


Use of MSRJE 


To illustrate an RJE application, Figure 1-2 shows a System/36 located at a 
regional office in Chicago and a host system located at corporate headquarters in 
New York. The regional office sends weekly sales totals g| to the host system, 
which processes the data and returns print data Q to the System/36 in Chicago. 
This data is then printed Q at the System/36. In addition to processing the reports 
for the Chicago office, the host system also updates the corporate sales files and 
generates weekly sales reports for corporate management Q, giving sales figures 
for the entire corporation. 

The System/36 in this example has communications and the MSRJE feature. An 
application program has been written to allow operators to enter sales invoices 
directly into a System/3 6 data file Q. A file has also been created that contains 
the JCL Q and commands needed by the host system to process the data and the 
utility control statements used to control the operation of MSRJE. 
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Figure 1-2. Example MSRJE Environment 

From Monday through Friday, the operators in Chicago enter the sales invoices 
into the data file on System/36. On Friday afternoon, MSRJE is started to send 
the collected data to the host system for processing. Once the data link is 
established, MSRJE reads the file that contains the MSRJE utility control 
statements and the host system JCL. The JCL is sent to the host system and the 
appropriate application is started there to process the sales data. The data file is 
then read by MSRJE and sent to the host system. Once the host application has 
processed the data, print data is returned to System/36 and printed. When all data 
has been sent, processed, and received, the System/36 operator ends MSRJE. 
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BSC Host Subsystems Supported by MSRJE 

Using MSRJE, System/36 can operate as an RJE work station when attached, 
through a data link on one or more System/36 lines, to the following BSC host 
subsystems: 

• Job Entry Subsystem 2 (JES2) running under MVS 

• Job Entry Subsystem 3 (JES3) running under MVS 

• Remote Entry Service (RES) running under OS/VS1 

• Remote Spooling Communications Subsystem (RSCS) running under VM/370 

SNA Host Subsystems Supported by MSRJE 

Using MSRJE, System/36 can operate as an RJE work station when attached, 
through a data link on one or more System/36 lines, to the following SNA host 
subsystems: 

• Job Entry Subsystem 2 (JES2) running under MVS 

• Job Entry Subsystem 3 (JES3) running under MVS 

• Virtual Storage Extended/Priority Output Writers, Execution Processors, and 
Input Readers (VSE/POWER) running under DOS/VSE 

• Remote Entry Service (RES) running under OS/VS1 

When MSRJE is used to communicate with an SNA host system, MSRJE can share 
a System/36 communications line with the following separate System/36 features: 

• The SSP-ICF SNA Upline Facility (SNUF) subsystem 

• SNA 3270 device emulation 

• The Distributed Systems Node Executive (DSNX) of Communications and 
System Management (C & SM) 

Notes: 

1. More than one active SNA subsystem can share the same line. 

2. More than one remote location on the same line can be active to one or more 
hosts. 
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System/36 Requirements for Supporting MSRJE 


The minimum system configuration required to support MSRJE is: 

• System/36 with a minimum main storage of 128K bytes 

If throughput is important, you should use at least 256K bytes of main storage. 
Depending on other system activity (3270 Device Emulation, OFFICE/36), 
384K storage with 200 mb of disk is recommended. 

• Communications adapter 

• Communications equipment 

— Modem or an X.21 adapter 
— X.25 equipment 

— A switched or nonswitched communications line 

— Protective couplers for a non-FCC registered modem on a switched line 
(US only) 

• System/3 6 System Support Program Product (SSP) 

• System/36 Communications feature 

Simultaneously, BSC MSRJE and SNA MSRJE can run on a total of eight 
communications lines. Separately, BSC MSRJE and SNA MSRJE can each run on 
up to eight communications lines. 
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Utilities Provided with MSRJE 


In addition to the communications support provided by MSRJE, two utilities are 
provided with the MSRJE feature to aid you in your use of MSRJE. These utilities 
are the MSRJE disk file utility and the MSRJE control table utility. 


MSRJE Control Table Utility 

You use the MSRJE control table utility (named RJTABLE) to define how output 
received from the host system is to be handled during an MSRJE session. You 
create tables using the RJTABLE procedure command and name each entry in the 
table. The names you assign to the entries in the table correspond to forms names 
sent by the host system with output data. When a name in the table matches a 
received forms name, the values specified in the table are used to control the 
processing of the output data. If no match is found in the table, a default entry is 
used. You can define table entries for print data and punch data, and you can also 
update the print default and punch default entries. 

Using the control table allows you to specify whether print data received is to be 
written to a disk file containing 256-character unprocessed records, sent directly to 
the printer, or spooled. You can specify that punch data be written to either a disk 
file as 256-character unprocessed records or a user-defined disk file. 

You can review and get a printout of the entire table or an entry in the table. 

The control table utility is described in Chapter 5. 

MSRJE Disk File Utility 

You use the MSRJE disk file utility (named RJFILE) to convert print data and 
punch data to printed output or data files after the data has been: 

• Received from the host system 

• Written to disk files that contain 256-character records 

Print data that was written to a disk file as 256-character unprocessed records (a 
compressed disk file) can be printed. Punch data that was written to a compressed 
disk file can be converted to files you define, and you can use those files as input to 
application programs or MSRJE. 

The disk file utility is described in Chapter 6. 
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Defining MSRJE for System/36 and the Host System 


Before you can use MSRJE to communicate with a host system, you must: 

• Define the System/3 6 communications environment 

• Define the RJE environment for MSRJE to System/3 6 

• Define the RJE environment to the host system for communicating with 
MSRJE 

When you define the RJE environment for MSRJE to System/36, you are 
configuring MSRJE. When you are defining the RJE environment to the host 
system, you are generating the host system communications network. Some of the 
items defined during MSRJE configuration must match items defined during the 
host system generation. You may either perform the host system generation and 
then base the MSRJE configuration on it, or perform the MSRJE configuration and 
then base the host system generation on the MSRJE configuration. In either case, 
you will have to work with the person who will be doing the host system generation 
to ensure that the MSRJE configuration and the host system generation match. 

Chapter 2 provides the information necessary to configure MSRJE. As you read 
Chapter 2, you will note that the items specified for MSRJE that must match values 
specified for the host system are so indicated. 

Chapter 7 describes the BSC host system generations; Chapter 8 describes the 
SNA host system generations. Whenever a value specified at the host system must 
match a value specified during MSRJE configuration, the corresponding MSRJE 
item is indicated. Appendix A contains host subsystem work sheets to help you 
during MSRJE configuration or host system generation. 
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Converting System/34 SRJE or MRJE Applications to System/36 
MSRJE 


The IBM System/34 System Support Program Product (SSP) provides two separate 
utilities to perform remote job entry. MRJE (MULTILEAVING Remote Job 
Entry) supports communications with BSC host systems, and SRJE (SNA Remote 
Job Entry) supports communications with SNA host systems. In addition, 
System/34 provides utilities for defining the forms control table (DCFUP) and 
printing data written to a disk file (DCSUP). If you are converting from 
System/34 SRJE or MRJE, refer to the manual Converting from System/34 to 
System/36 for information about converting to System/36 MSRJE. That manual 
also provides information about converting from DCFUP to the MSRJE control 
table utility, and from DCSUP to the MSRJE disk file utility. 


MSRJE and System/36 Resource Security 

If any of the files you intend to use with MSRJE are protected under the resource 
security capabilities of System/36, you must be sure that the operator who signs on 
to MSRJE is authorized to use those files. Security of files and libraries is based on 
the user ID and password. 

Whenever MSRJE attempts to access a file or library and the file or library is 
protected, the user ID is compared to the list of authorized users for that file or 
library. If the user is not authorized, a message is logged, and the file is not 
accessed. 

To ensure that MSRJE can access the forms control tables you create (as described 
in Chapter 5), you should authorize user MSRJE to have at least read access to the 
forms control table. 

For further information on resource security, refer to the manual System Security 
Guide. 
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Chapter 2. Before Running MSRJE 


Before you can use MSRJE to communicate with a host system, you must: 

1. Install the MSRJE feature as a part of the system configuration 

2. Define a configuration for MSRJE 

Installing MSRJE 


MSRJE can be installed on System/36 during the initial system configuration, or 
when you change the system configuration. In either case, the CNFIGSSP 
procedure is used to describe your System/3 6 environment. 

MSRJE is installed during the program products definition of the SSP (System 
Support Program Product). For a complete description of installing the program 
products, including MSRJE, refer to the manual Changing Your System 
Configuration. 
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Defining an MSRJE Configuration 


Defining a configuration for MSRJE consists of defining a line member and a 
subsystem member. 

Many of the values specified during MSRJE configuration must match values 
specified at the host system during generation of the communications network. For 
example, the number of readers, printers, and punches that can communicate with 
the host system at one time are defined during host subsystem generation. These 
values are also specified during MSRJE configuration# 

Host system work sheets are provided in Appendix A. It is suggested that you do 
either of the following: 

• Have the host system personnel provide you with the information for the work 
sheet and then use those values to configure MSRJE. 

• Fill out the work sheet yourself, configure MSRJE using the values you 
specified on the work sheet, and then provide that information to the host 
system personnel. They can then use it to generate the host communications 
network and subsystem. 

You define the System/36 line and subsystem members by entering the 
CNFIGICF procedure command from any command-capable display station. The 
command has no parameters. The CNFIGICF procedure then presents a series of 
displays that prompt you for the needed configuration information. 

When you are running the CNFIGICF procedure, you can request help text for all 
the displays by pressing the Help key. You start CNFIGICF by entering the 
CNFIGICF procedure command, which has no parameters. 


MSRJE Line Members 


A line member contains the description of the physical characteristics of the 
communications line that will be used by MSRJE and a description of one or more 
remote systems (host systems) with which MSRJE will communicate. The 
information in the line description is needed to establish the connection with the 
host system; it does not describe any specifics of the host subsystem or MSRJE. 
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One remote system can be defined within a line member for a nonswitched line; up 
to 32 remote systems can be defined within a line member for a switched line. In 
general, the remote system definition describes the characteristics of one host 
system. However, that host system could contain several subsystems, such as 
JES2, JES3, IMS, CICS, or RES. The remote system definition in the line member 
describes the characteristics of the host system (the computer itself) when 
System/3 6 is communicating with any of the host subsystems. 

The number of host systems you define depends entirely on your communications 
environment. For example, if you will be using MSRJE on a nonswitched line, or 
on a switched line to communicate with only one host system, you would define 
only that system. If you will be using MSRJE on a switched line and will be 
communicating with more than one host system, you would define each host 
system. 

Note that SNA MSRJE can use the same remote system definition as is used by 
SNA 3270 device emulation or the SSP-ICF SNA Upline Facility (SSP-ICF SNUF) 
for application programs or for the Distributed Systems Node Executive (DSNX) 
of Communications and System Management (C & SM). 

See the manual -Using System/36 Communications for information on defining line 
members. 
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MSRJE Subsystem Members 


A subsystem member contains the information necessary for MSRJE to 
communicate with one or more remote locations. For MSRJE, a remote location 
definition describes the characteristics of one RJE subsystem (such as JES2 or 
RES) in a host system (a remote system in the line member). Actually, since the 
host system can have many RJE work stations defined, an MSRJE remote location 
describes one work station for one host system. 

When you define a subsystem member, you must specify the name of the line 
member that is to be used by the subsystem member. You then define one or mbre 
remote locations for each of the remote systems within the line member. When 
defining a subsystem member, you are shown the names of the remote systems that 
are defined within the associated line member. You then specify the name of the 
remote system for which you are defining a remote location. 

You specify the following during the definition of a remote location: 

• The name of the remote location. This name is used on the ENABLE and 
MSRJE procedure commands. 

For SNA, more than one location can be specified. You can then communicate 
with more than one location at a single remote system on a line. 

• Whether the location is to be activated when an ENABLE procedure command 
specifying the subsystem member, but no location name,4s enterpd. 

• The name of the host system. 

• How long MSRJE is to wait before ending a session after the MSRJE console 
has been released and all readers, printers, and punches have ended. 

• The priority assigned to MSRJE readers, printers, and punches. 

• The host system logon/signon information. 

• The MSRJE configuration, including: 

—- The number of MSRJE readers, printers, and punches. 

- The number of readers defined for MSRJE at the host system. 

- The sequence number to be assigned to print or punch files generated by 
MSRJE. 

- The forms control table and forms set to use. 

- Whether text transparency can be used. 

- Default values for certain parameters on the MSRJE procedure command. 
— For SNA MSRJE, the maximum number of sessions allowed by the host 

system. 

- For SNA MSRJE, the minimum number of sessions allowed. (MSRJE 
terminates if the number of active sessions is less than this value.) 
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Examples of MSRJE Configurations 


The following illustrations show the relationship between line members, remote 
systems, subsystem members, and remote locations. In all of the examples, the line 
and subsystem members are stored in a user library named RJELIB (a subsystem 
member and its associated line member must be stored in the same library). 

The first illustration shows a System/3 6 using MSRJE on a nonswitched line 
(System/36 line 1) to communicate with a BSC host system running RES. A line 
member (named BSCLINE1) with one remote system (named BSCHOST1) and a 
subsystem member (named BSCSUB1) with one remote location (named 
BSCLOC1) have been defined. The following ENABLE command is used to 
activate the communications support and the remote location: 


ENABLE BSCSUB1,RJELIB,1,,BSCL0C1 

System/36 Host System 



S7909002-0 


The next illustration shows a System/3 6 using MSRJE on a switched line to 
communicate with two SNA host systems (one is running JES2 and the other 
RES). The line member is named SNASWT2, the remote systems are named 
SNARES and SNAJES2, the subsystem member is named SNASUB2, and the two 
remote locations (one for each remote system) are named JES2LOC and 
RESLOC. 
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First, the line and subsystem member are used to communicate with the JES2 
subsystem: 


ENABLE SNASUB2,RJELIB,2,,JES2LOC 

System/36 Host System 



Then, the same line and subsystem member are used to communicate with the RES 
subsystem: 


ENABLE SNASUB2,RJELIB, 2, ,RESLOC 

System/36 Host System 
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Defining an MSRJE Subsystem Member Configuration for BSC 


During subsystem member configuration, you describe, for each remote system 
specified in a line member, the local (System/36) characteristics of MSRJE. (See 
the manual Using System/36 Communications for information on defining line 
members.) Many local characteristics are affected by what has been specified for 
communicating with MSRJE by the host system. 

You should refer to the host system work sheets (in Appendix A) during subsystem 
configuration. You will have to use the values provided on the work sheet by the 
host system personnel, or you will need to enter the values on the work sheet and 
give it to the host system personnel. 

In the following example, the subsystem member is named BSCSUB1 and the 
remote location is named BSCLOC1. This subsystem member is associated with 
the line member BSCLINE1. 

Display 1.0 SSP-ICF Configuration Member Definition 



SSP-ICF CONFIGURATION MEMBER DEFINITION 


1. Configuration member name . 

2. Library name.RJELIB 

3. Select one of the following: 

1. Create new member 

2. Edit existing member 

3. Create new member from existing member 

4. Remove a member 

5. Review a member 

Option.1-5 



Cmd7-End Cmdl9-Cancel 


Help text available throughout CNFIGICF by pressing the Help key 




Note: On this display and on all displays that follow, you can press command key 7 
to end the CNFIGICF procedure or command key 19 to cancel the 
CNFIGICF procedure. Using command key 7 saves any valid definitions you 
have performed; using command key 19 causes you to lose any definitions you 
have performed since you last entered the CNFIGICF procedure command . 
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1. Configuration member name: Specify a name for this subsystem member. The 
name is used to store the member in a library and is referenced by the 
ENABLE and DISABLE procedure commands (these commands are 
described in Chapter 3). In the example, BSCSUB1 is used. 

2. Library name: Specify the name of the library in which you want this member 
stored. The default library is the current user library (RJELIB in the 
example). It is recommended that you do not store the member in the system 
library (#LIBRARY) because members you store in #LIBRARY may be lost 
if a release update is later performed. 

The subsystem member must be stored in the same library as the line member 
with which it will be associated. 

3. Select one of the following: Specify the number (1 through 5) that 
corresponds to the operation you want to perform. The options are: 

1. Create a new member allows you to specify the configuration values for a 
new subsystem member. 

2. Edit existing member allows you to view and/or change the values 
previously specified for a subsystem member. 

3. Create a new member from an existing member allows you to use an 
existing subsystem member as the basis for a new subsystem member. 
You need change only those values necessary. The existing member is 
not changed. 

4. Remove a member allows you to remove a subsystem member from the 
library. Note that the definition is no longer available once it is removed. 

5. Review a member allows you to view the values specified for a subsystem 
member. No changes can be made. 

If you select option 3 for prompt 3, display 1.0 is updated with two additional 
prompts when you press the Enter key. If you select any other option, display 2.0 
is presented. 

Because a new subsystem member is being created in the example, the next display 
would be display 2.0. However, to illustrate how display 1.0 is updated if option 3 
is selected for prompt 3, the next display described is the updated version of 
display 1.0. 
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SSP-ICF CONFIGURATION MEMBER DEFINITION 


W1 


1 .0 


1. Configuration member name . BSCSUB1 

2. Library name.RJELIB 


3. Select one of the following: 

1. Create new member 

2. Edit existing member 

3. Create new member from existing member 


4. Remove a member 

5. Review a member 

Option.1-5 3 

4. Existing member name . 

5. Existing member library name . RJELIB 


Cmd7-End Cmdl9-Cancel 





4. Existing member name: This prompt appears only if option 3 was selected for 
prompt 3. Specify the name of the existing subsystem member that you want 
to use as the basis for a new subsystem member. 

5. Existing member library name: This prompt appears only if option 3 was 
selected for prompt 3. The default is the name specified for prompt 2 
(RJELIB). Specify the name of the library in which the member named in 
prompt 4 is stored. 
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Display 2.0 SSP-ICF Configuration Member Type 


2.0 


SSP-ICF CONFIGURATION MEMBER TYPE 


BSCSUB1 


W1 


1. Select the member type from the following options: 


1 
2 . 

3. 

4. 

5. 

6 . 

Option 


INTRA 
BSC line member 
BSC subsystem member 
SNA/SDLC line member 
SNA subsystem member 
SNA/X.25 line member 


1-6 


Cmd3-Previous display Cmdl9-Cancel 



Note: On this display and all displays that follow for subsystem member 

configuration, the member name (BSCSUB1), as specified for prompt 1 on 
display 1.0, is shown in the upper right-hand corner. Pressing command key 3 
returns you to the previous display. 

1. Select the member type from the following options: Specify the type of 
member that you are defining. Select option 3 (BSC subsystem member). 
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Display 20.0 BSC Subsystem Member Selection 



BSC SUBSYSTEM MEMBER SELECTION 


BSCSUB1 



1. Line member name . 

2. Select subsystem type from the following options: 

1. BSC CCP 

2. BSC CICS 

3. BSCEL 

4. BSC IMS/IRSS 

5. BSC 3270 

6. BSC MSRJE 

Option.1-6 


Cmd3-Previous display 


Cmd19-Cancel 



1. Line member name: Specify the name of the line member with which this 
subsystem member is to be associated. The line member name was specified 
on display 1.0 during line member configuration. 

For the example, the subsystem member is associated with the BSC line 
member named BSCLINE1. 

2. Select subsystem type from the following options: Specify option 6 (BSC 
MSRJE). 

When you complete display 20.0 and press the Enter key, you begin defining the 
local characteristics of MSRJE, beginning with display 29.0. 
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Display 29.0 Remote Location Selection 


r 


29.0 


REMOTE LOCATION SELECTION 


1. Select from the following options: 
1-Create 


Option . 

2. Remote location name . 

3. Remote system name . . 

4. Existing location name 


OPTION LOCATION REMOTE SYSTEM 

BSCHOST1 


BSCSUB1 



1 


Page 1 of 1 


Cmd8-Reset Cmdl9-Cancel Roll-Page 

No remote locations are configured 




1. Select from the following options: 

1- Create. Define a new location. 

Note: If no remote locations exist within the remote system , option 1, 

Create, is the only option available. 

2- Edit. Change an existing location. 

3- Create from existing. Define a new remote location using an existing 

remote location as the base. 

4- Remove. Delete a remote location. It will no longer exist in this 

member. 

5- Review. Display an existing remote location. 

2. Remote location name: Enter the name of the remote location that this 
subsystem communicates with. This name is used in the ENABLE, DISABLE, 
and MSRJE procedures to start or stop communications with this remote 
location. This name also appears in system messages to help the operator 
associate the message with a particular remote location. No two remote 
location names can be the same in this subsystem member. 

3. Remote system name: Enter the name of the remote system for which this 
remote location is being defined. 

4. Existing location name: Enter an existing location name if you are using option 
3 to create a new remote location using an existing location as the base. 
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On the bottom half of the display, all previously defined remote locations are listed 
along with the remote systems they are associated with. You may edit, remove, or 
review any of these remote locations by entering the correct option number in the 
column to the left of the remote location you want to work with. Use the Roll keys 
to page through the list of remote locations. 

Display 30.0 Remote Location Definition 



The name you specified for the Remote system prompt on the previous display 
is presented here (BSCHOST1 in the example). 

The Remote location name specified here is used in the MSRJE, ENABLE, 
and DISABLE procedure commands when you want to communicate with 
this remote system. (See Chapter 3 for a description of these procedure 
commands.) In the example, the remote location is named BSCLOC1. 

Note: The remote system name and the remote location name are presented for 
information only. They cannot be changed on this display. 

1. Activate location at ENABLE?: Specify Y if you want the remote location 
enabled when the ENABLE procedure command (without a remote location 
name specified) is entered that specifies this subsystem member. If you 
specify N for this prompt, you must enable the remote location by specifying 
the Remote location name on an ENABLE procedure command. 

The ENABLE procedure command is described in Chapter 3. 

On each of the following displays, the remote system name (BSCHOST1 in the 
example) and the remote location name (BSCLOC1 in the example) are displayed 
below the display heading. 
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Display 34.0 MSRJE Subsystem Member Attributes 


r 


34.0 


MSRJE SUBSYSTEM MEMBER ATTRIBUTES 


BSCSUB1 



Remote system BSCHOST1 Remote location BSCLOC1 


1. Host name . 

2. Termination delay in minutes . 0-99,blank 

3. Priority . H,M,N,L N 


6. Display informational messages? . Y,N Y 

Cmd19-Cancel 




1. Host name: Specify the name of the host system with which this 

configuration record is to be used to communicate. Valid entries are: 

. JES2 for JES2 under MVS 

• JES3 for JES3 under MVS 

. RES for RES under OS/VS 1 

. VM370 for VM370 RSCS 

In the example, RES is used. 


2-14 Multiple Session Remote Job Entry Guide 







2. Termination delay in minutes: Specify the length of time, in minutes, that 
MSRJE will remain active after all readers, printers, and punches have 
finished and the MSRJE console has been released. Valid values are 00 
through 99 or blank. If blank is specified, MSRJE will not terminate 
automatically and must be terminated by entering the MSRJE END utility 
control statement or the DISABLE procedure command. 

3. Priority: Specify the priority level that is to be assigned to readers, printers, 
and punches activated by MSRJE. N (normal) is the default. All priority 
values correspond to your definitions of priority levels on the 

// ATTR OCL statement. The valid selections are: 

• H for high priority 

• N for normal job priority 

• M for medium priority 

• L for low priority 

The MSRJE console always has high (H) priority. 

For a description of the // ATTR OCL statement, see the System Reference 
manual. 

6. Display informational messages?:If you specify Y (Yes) for this prompt, all 
MSRJE informational messages are displayed on the MSRJE console. These 
messages inform the MSRJE operator of local MSRJE activities. This prompt 
does not control messages received from the remote host system. 

When you complete display 34.0 and press the Enter key, display 35.0 appears to 
prompt you for the host system signon/logon information. 
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Display 35.0 MSRJE Logon Attributes 


r 


35.0 


MSRJE LOGON ATTRIBUTES 


Remote system BSCHOST1 Remote location BSCLOC1 


BSCSUB1 



3. Enter host LOGON/SIGNON command below: 

10_: . . .20_: . . . 30_: . . .40_: . . . 50_: . . .60-: . . . 70 


Cmdl9-Cancel 






The information specified for the logon/signon must match what the host system is 
expecting. The following formats are general for the supported host systems. 

Refer to the host system work sheet (in Appendix A), or contact the host system 
personnel to determine the exact format of the information. 

3. Enter host LOGON/SIGNON command below: Specify the LOGON or 
SIGNON command that is required by the host system with which this 
configuration of MSRJE will be communicating. The formats for the 
supported host systems are: 

• JES2 

/*SIGNON fREMOTEnni [passwordl] [password2] 

(RMTnn J 

S7909035-0 


The command begins in position 1. The REMOTEnn or RMTnnn 
parameter begins in position 16 and specifies the terminal number of 
System/36 as specified by the RMTnnn parameter of the JES2 work 
station definition. 

The passwordl parameter is optional and, if used, must be 1 through 8 
alphameric characters beginning in position 25 and must match the 
password specified for the PASSWORD subparameter of the LINEnnn 
parameter during the definition of remote work stations for JES2 at the 
host system. 
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The password2 parameter is optional and, if used, is 1 through 8 
alphameric characters beginning in position 73 and must match the value 
specified for the PASSWORD parameter of the RMTnnn parameter 
during remote work station definition for JES2 at the host system. 

JES3 

/♦SIGNON namex [A] passwordl password2 

The command begins in position 1. The namex parameter begins in 
position 16 and must match the value specified for the N parameter in the 
RJPTERM statement during JES3 generation at the host system. 

The A is optional and, if used, must be in position 22. It identifies 
System/3 6 to the host system as being a programmable RJE work station 
with automatic readers. 


The passwordl parameter must be 1 through 8 alphameric characters 
beginning in position 25. It must match the value specified for the P 
parameter in the RJPLINE statement at the host system. 

The password2 parameter begins in position 35. It is 1 through 8 
alphameric characters and must match the value specified for the P 
parameter in the RJPTERM statement at the host system. 


RES 


LOGON userid[/password] TERM(termid)[PROC(procname)] 


Tnotices 

\NONOTICESj 


I 


'mail 1 

w NOMAILj 


S7909008-0 


The command begins in position 1. The userid parameter identifies 
System/3 6 to the host system, and must match the value specified at the 
host system for the ADD subcommand of the ACCOUNT command. 


The password parameter is optional and, if used, is 1 through 8 
alphameric characters and must be separated from the userid by a slash 
(/). In addition, the value must match the entry made in the ADD 
subcommand for the specified user. 


TERM(termid) specifies the terminal identification number and must 
match the value entered for the TERMID parameter for System/3 6 in 
the TERMINAL macro for the RTAM generation at the host system. 

The PROC(procname) allows you to specify a catalogued procedure 
(procname) at the host system that is to be executed as a part of the 
logon process. 

NOTICES, the default, allows you to specify that all general notices from 
the host system are to be listed automatically after logon. NONOTICES 
inhibits the listing of notices. 
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MAIL, the default, allows you to specify that all messages directed to 
your System/36 be automatically listed after logon. NOMAIL inhibits 
the listing of messages. 

. VM/370 RSCS 

/♦SIGNON REMOTEnn [password] 

The command begins in position 1. The REMOTEnn parameter begins in 
position 16 and defines the remote terminal number of System/36 as 
defined in the START command at the host system. 

The password parameter is optional and, if used, is 1 through 8 alphameric 
characters beginning in position 25 and must match the password specified 
at the host system in the START command for this terminal. 

Because the example is for communicating with RES, the value entered is: 

LOGON USER1/PASS1 TERM(21) PROC(MRJEPROC) 

After you press the Enter key, you define the MSRJE environment by completing 
the information on displays 36.0 and 37.0. 


I 


I 
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Display 36.0 MSRJE Printer/Punch Attributes 


r 


36.0 


MSRJE PRINTER/PUNCH ATTRIBUTES 


Remote system BSCHOST1 Remote location BSCLOC1 


1. Forms control table name . 

2. Forms set.0-8 

3. Maximum number of printers . 0-7 

4. Printer file sequence number . 1-99 

5. Maximum number of punches . 0-7 

6. Punch file sequence number.1-99 


BSCSUB1 


0 

01 

01 

01 

01 


W1 


Cmdl9-Cancel 



1. Forms control table name: Specify the name of the forms control table that is 
to be used with this MSRJE configuration to control the handling of print and 
punch data streams received from the host system. The forms control table is 
created by the MSRJE forms control table utility (see Chapter 5 for 
information on the forms control table utility). 

If you do not specify a name for this prompt, MSRJE handles print and punch 
data streams as described in the “Print Default Entry” and “Punch Default 
Entry” sections of Chapter 5. 

2. Forms set: Define the use of host forms information from the forms set table. 
This internally maintained table contains entries for all print and punch 
devices supported by MSRJE. Use of the table allows MSRJE to save the 
forms mounted for each device from LOGOFF of one session to LOGON of 
another session. This is useful if the host system views System/36 as the type 
of device that keeps the same form mounted all the time. 

Valid entries are 0 through 8; 0 is the default. If 0 is specified, MSRJE will 
not maintain a forms set table for this location and, therefore, will not 
maintain the forms names between sessions. Because the table can contain 
the definitions of forms for up to eight separate host systems, the value 
entered here defines which set you want used when this configuration is 
active. 

If the same forms set (other than 0) is specified in different MSRJE 
configurations, unexpected results may occur. 

Note: Initially, the forms name for all devices of all forms sets is all blanks. 
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3. Maximum number of printers: Specify the maximum number of printer tasks 
that can be active. Enter a value from 0 through 7; the default is 01. This 
value must be at least as large as the number of printers specified at the host 
system for this MSRJE configuration. 

The value for the number of printers is specified at the host system as 
follows: 

• JES2, specified in the NUMPR subparameter of the RMTnnn parameter 
on the JES2 work station definition 

• JES3, specified in the PR subparameter of the RJPTERM parameter on 
the JES3 work station definition 

• RES, specified in the PTRS parameter of the TERMINAL macro for the 
RTAM stage 1 generation 

• VM/370 RSCS, always 0 or 1, depending on whether you expect print 
output 

If the host system work sheet has been filled out, refer to it for the correct 
value. If you are configuring MSRJE before the host system is generated, 
enter the Maximum number of printers on the work sheet. 

The total number of printers (specified here) and punches (specified for 
prompt 5) must be 8 or less. 

4. Printer file sequence number: Specify a number from 01 through 99 to define 
the beginning sequence number for printer files written to disk; the default is 
01. See Chapter 3 for a description of print output, and see Chapter 5 for a 
description of the forms control table entries that control print data written to 
disk. 

5. Maximum number of punches: Specify the maximum number of punch tasks 
that can be active. Enter a value from 0 through 7; the default is 01. This 
value must be at least as large as the number of punches specified at the host 
system for this MSRJE configuration. 

The value for the number of punches is specified at the host system as 
follows: 

• JES2, specified in the NUMPU subparameter of the RMTnnn parameter 
on the JES2 work station definition 

• JES3, specified in the PU subparameter of the RJPTERM statement on 
the JES3 work station definition 

• RES, specified in the PCHS parameter of the TERMINAL macro for the 
RTAM stage 1 generation 

• VM/370 RSCS, always 0 or 1, depending on whether you expect punch 
output 
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If the host system work sheet has been filled out, refer to it for the correct 
value. If you are configuring MSRJE before the host system is generated, 
enter the Maximum number of punches on the work sheet. 

The total number of punches (specified here) and printers (specified for 
prompt 3) must be 8 or less. 

6. Punch file sequence number: Specify a number from 01 through 99 to define 
the beginning sequence number for punch files written to disk; the default is 
01. See Chapter 3 for a description of punch output, and see Chapter 5 for a 
description of the forms control table entries that control punch data written 
to disk. 

The entries on display 36.0 define the printers and punches used for MSRJE. Once 
you press the Enter key, the last display, display 37.0, is presented. Display 37.0 
allows you to define the readers used by MSRJE and defined at the host system. 
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Display 37.0 MSRJE Reader Attributes 



MSRJE READER ATTRIBUTES 


Remote system BSCHOST1 Remote location BSCLOC1 


BSCSUB1 



1 . 
2 . 

3. 

4. 

5. 

6 . 


Maximum number of MSRJE readers . 1-32 01 

Maximum number of host readers.1-7 01 

Transparency? . Y,N N 

Specify default value for TYPE . P,D,S P 

Specify default value for CMD.Y,N Y 

Specify default value for DEL.Y,N N 


Cmd19-Cancel 



1. Maximum number of MSRJE readers: Specify the number, from 1 through 
32, of readers that can be active at one time for this MSRJE configuration. 
The default is 1. 

By specifying a value that is greater than the value specified for the Maximum 
number of host readers prompt, you can start MSRJE readers and then allow 
them to wait for a host reader to become available. 

The number of readers that you specify here depends on your RJE 
environment. For example, if several users will be signing on to MSRJE and 
sending data files to the host subsystem, you should specify as many readers 
as you expect will be needed at one time. If all the host readers (prompt 2, 
Maximum number of host readers) are in use, MSRJE will display a message 
and allow you to wait for a host reader to become available. You do not have 
to re-enter a request to start a reader. 
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Maximum number of host readers: Specify the maximum number of readers 
that can be sending data to the host system at one time. The value entered 
can be from 1 through 7; the default is 1. This value should not exceed the 
number of readers specified for the host during host system generation. The 
maximum number of readers is specified at the host subsystems as follows: 

• JES2, specified in the NUMRD subparameter of the RMTnnn parameter 
on the JES2 work station definition 

• JES3, specified in the RD subparameter of the RJPTERM statement on 
the JES3 work station definition 

• RES, specified in the RDRS parameter of the TERMINAL macro for the 
RTAM stage 1 generation 

• VM/370 RSCS, always 1 

If the host system work sheet has been filled out, refer to it for the correct 
value. If you are configuring MSRJE before the host system is generated, 
enter the Maximum number of host readers on the work sheet. 

Transparency?: Specify whether text transparency can be used with this 
MSRJE configuration. N, the default, specifies that text transparency cannot 
be used. Y specifies that text transparency can be used. 

Transparency is normally used if you will be sending and receiving data that 
contains data characters, which could be handled as control characters by the 
BSC protocol. Normally, this occurs in object modules (load members) or 
binary data streams. 

Whether you can use transparency depends on the value specified at the host 
subsystem, as follows: 

• JES2, specified in the TRANSP/NOTRANSP subparameter of the 
LINEnnn parameter (defines whether the line supports transparency); 
and in the TRANSP/NOTRANSP subparameter of the RMTnnn 
parameter (defines whether System/36 can use transparency) 

• JES3, specified in the F subparameter of the RJPTERM parameter. 
F=NTRS specifies no transparency. Transparency is supported if 
F=NTRS is not specified. 

• RES, subparameter 2 of the LDESCR parameter in the LINE macro 
defines whether the line supports transparency; subparameter 4 of the 
TDESCR parameter of the TERMINAL macro determines whether 
System/36 can use transparency. Both macros are defined for the 
RTAM stage 1 generation. 

• VM/370 RSCS, always sends punch data in transparent text mode and 
accepts transparent data. 

If the host system work sheet has been filled out, refer to it for the correct 
value. If you are configuring MSRJE before the host system is generated, 
enter your response to the Transparency? prompt on the work sheet. 
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4. ( Specify default value for TYPE: • Specifies the default value to be used for the 

TYPE parameter on the MSRJE procedure or in READFILE utility control 
statements entered when this configuration is active. Specifying a value here 
is useful if most MSRJE procedure or READFILE statements you use will 
have the same TYPE parameter value. Refer to “Starting an MSRJE 
Session” in Chapter 3 or “READFILE Utility Control Statement” in 
Chapter 4 for a complete description. 

Valid entries are: 

• P for a procedure member 

• D for a disk file 

• S for a source member 

5. Specify default value for CMD: Specify the default value to be used for the 
CMD parameter on the MSRJE procedure or in the READFILE MSRJE 
control statement for utility control statements entered when this 
configuration is active. Y indicates that the file contains utility control 
statements (utility control statements are described in Chapter 4); N indicates 
that the file does not contain utility control statements. 

Specifying a value here is useful if most MSRJE procedure or READFILE 
statements you use will have the same CMD parameter value. Refer to 
“Starting an MSRJE Session” in Chapter 3 or “READFILE Utility Control 
Statement” in Chapter 4 for a complete description. 

6. Specify default value for DEL: Specifies the default value to be used for the 
DEL parameter on the MSRJE procedure or in the READFILE utility 
control statement if no specification is made in the command for the 
parameter. Y specifies that deleted records in the file are to be transmitted to 
the host system. N specifies that deleted records in the file are not to be 
transmitted to the host system. 

Specifying a value here is useful if most MSRJE procedure or READFILE 
statements you use will have the same DEL parameter value. Refer to 
“Starting an MSRJE Session” in Chapter 3 or “READFILE Utility Control 
Statement” in Chapter 4 for a complete description. 

Once you have completed display 37.0, display 29.0 is again displayed, and you can 
then define another MSRJE configuration. To end the definition of MSRJE 
configurations, press command key 7. Display 1.0 is then presented, and you can 
either define another line or subsystem member, or end the CNFIGICF procedure 
by pressing command key 7. 
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Defining an MSRJE Subsystem Member Configuration for SNA 


During subsystem member configuration, you can describe, for each remote system 
specified in a line member, the local (System/36) characteristics of MSRJE. (See 
the manual Using System/36 Communications for information on defining line 
members.) Many local characteristics are affected by what has been specified at 
the host system for communicating with MSRJE. 

You should refer to the host system work sheets (in Appendix A) during subsystem 
configuration. You will have to use the values provided on the work sheet by the 
host system personnel, or you will need to enter the values on the work sheet and 
give it to the host system personnel. 

In the following example, the subsystem member is named SNASUB1 and the 
remote location is named SNALOC|. This subsystem member is associated with 
the line member SNALINE 1. 


Display 1.0 SSP-ICF Configuration Member Definition 



On this display and all displays that follow, you can press command key 7 to end 
the CNFIGICF procedure or command key 19 to cancel the CNFIGICF command. 
Using command key 7 saves any valid definitions you have performed; using 
command key 19 causes you to lose any definitions you have performed since you 
last entered the CNFIGICF procedure command. 
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1. Configuration member name: Specify a name for this configuration of the 
subsystem. This name is used to store the member in a library and is 
referenced in the ENABLE and DISABLE procedure commands. In the 
example, the subsystem member is named SNASUB1. 

2. Library name: Specify the name of the library in which you want this member 
stored. The default is the current user library (RJELIB in the example). You 
can use that library or specify the name of another user library. It is 
recommended that you do not store the member in the system library 
(#LIBRARY). If you store the member in #LIBRARY, it may be destroyed 
if a System/36 release update is performed. 

The library specified here must be the same library in which the associated 
line member (SNALINE1 in the example) is stored. 

3. Select one of the following: Specify the number (1 through 5) that 
corresponds to the operation you want to perform. The options are: 

1. Create a new member allows you to specify the configuration values for a 
new subsystem member. 

2. Edit existing member allows you to view and/or change the values 
previously specified for a subsystem member. 

3. Create a new member from an existing member allows you to use an 
existing subsystem member as the basis for a new subsystem member. 
You need change only those values necessary. The existing subsystem 
member is unchanged by this option. 

4. Remove a member allows you to remove a subsystem member from the 
library. Note that the definition is no longer available once it is removed. 

5. Review a member allows you to view the values specified for a subsystem 
member. No changes can be made. 

If option 3 is selected for prompt 3, this display is updated with two additional 
prompts when the the Enter key is pressed. If any other option is selected, display 
2.0 is presented. 

Because a new subsystem member is being created in the example, the next display 
would be display 2.0. However, to illustrate how display 1.0 is updated if option 3 
is selected for prompt 3, the next display described is the updated version of 
display 1.0. 
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SSP-ICF CONFIGURATION MEMBER DEFINITION 
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1 .0 


1. Configuration member name . 

2. Library name . 

3. ^ei-ecf one of the following: 

1. Create new member 
T. Edit existing member 

3. Create new member from existing member 

4. Remove a member 

5. Review a member 

Option . 

4. Existing member name . 

5. Existing member library name . 


Cmd7-End Cmdl9-Cancel 



SNASUB1 - 
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RJELIB 
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4. Existing member name: This prompt appears only if option 3 was selected for 
prompt 3. Specify the name of the existing subsystem member that you want 
to use as the basis for the new subsystem member. 

5. Existing member library name: This prompt appears only if option 3 was 
selected for prompt 3. Specify the name of the library in which the member 
named in prompt 4 is stored. The default is the value specified for prompt 2 
(RJELIB in the example). 
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Display 2.0 SSP-ICF Configuration Member Type 



Note: On this display and all displays that follow for subsystem member 

configuration, the member name (SNASUB1), as specified for prompt 1 on 
| display 1.0 , is shown in the upper right corner. Pressing command key 3 

returns you to the previous display. 

1. Select the member type from the following options: Specify the type of 

member that you are defining. Specify option 5 (SNA subsystem member). 
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Display 21.0 SNA Subsystem Member Selection 



SNA SUBSYSTEM MEMBER SELECTION 


Line member name 


Select subsystem type: 

1. Peer 

2. SNA Upline 

3. SNA 3270 
Finance 

C 5? SNA MSRJE 
6. APPC 

Option . 


SNASUB1 


W1 


Pf&lFK 


Cmd3-Previous display 



Cmdl9-Cancel 



1. Line member name: Specify the name of the line member with which this 
subsystem member is to be associated. The line member name was specified 
on display 1.0 during line member configuration. 

For the example, the subsystem member is associated with the SNA line 
member named SNALINE1. 

2. Select subsystem type: Specify option 5 (SNA MSRJE). 

When you complete display 21.0 and press the Enter key, you begin defining the 
local characteristics of MSRJE, beginning with display 29.0. 


Chapter 2. Before Running MSRJE 2-29 





Display 29.0 Remote Location Selection 


r 


29.0 


REMOTE LOCATION SELECTION 


SNASUB1 



1. SeJLect from the following options: 

{'Jh/Create 

Option . 

2. Remote location name . 

3. Remote system name . 


OPTION LOCATION REMOTE SYSTEM 
SNAHOST1 


•<S'<s fi t P r AL. 


Page 1 of 1 


Cmd8-Reset Cmd19-Cancel Roll-Page 

No remote locations are configured 


j 


1. Select from the following options: 

1- Create. Define a new location. 

Note: If no remote locations exist within the remote system, option 1, 
Create, is the only option available. 

2- Edit. Change an existing location. 

3- Create from existing. Define a new remote location using an existing 

remote location as the base. 

4- Remove. Delete a remote location. It will no longer exist in this 

member. 

5- Review. Display an existing remote location. 

2. Remote location name: Enter the name of the remote location that this 
subsystem communicates with. This name is used in the ENABLE, DISABLE, 
and MSRJE procedures to start or stop communications with this remote 
location. This name also appears in system messages to help the operator 
associate the message with a particular remote location. No two remote 
location names can be the same in this subsystem member. 

3. Remote system name: Enter the name of the remote system for which this 
remote location is being defined. 
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On the bottom half of the display, all previously defined remote locations are listed 
along with the remote systems they are associated with. You may edit, remove, or 
review any of these remote locations by entering the correct option number in the 
column to the left of the remote location you want to work with. Use the Roll keys 
to page through the list of remote locations. 
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Display 30.0 Remote Location Definition 



The name you specified for the Remote system prompt on display 29.0 is presented 
here (SNAHOST1 in the example). 

The Remote location name specified here is used in the MSRJE, ENABLE, and 
DISABLE procedure commands when you want to communicate with this remote 
system. (See Chapter 3 for a description of these procedure commands.) In the 
example, the remote location is named SNALOC1. 

Note: The remote system name and the remote location name are presented for 
information only. They cannot be changed on this display. 

1. Activate location at ENABLE?: Specify Y if you want the remote location 
enabled when the ENABLE procedure command (without a remote location 
name specified) is entered that specifies this subsystem member. If you 
specify N for this prompt, you must enable the remote location by specifying 
the Remote location name on an ENABLE procedure command. 


The ENABLE procedure command is described in Chapter 3. 


-More than one remote location can be active on the same line for §NX~ -- 
MSRJE. This means that you can have more than one RJE terminal active to 
.j Hie or more remote locations at one remote (host) system. . — 


On each of the following displays, the remote system name (SNAHOST1 in the 
example) and the remote location name (SNALOC1 in the example) are displayed 
below the display heading. 


2-32 Multiple Session Remote Job Entry Guide 






Display 34.0 MSRJE Subsystem Member Attributes 


34.0 


MSRJE SUBSYSTEM MEMBER ATTRIBUTES 


SNASUB1 


W1 


Remote system SNAHOST1 


Remote location SNALOC1 


ft V 


1. Host name . 

2. Termination delay in minutes . 

3. Priority . H,M,N,L t N 

4. Maximum number of sessions.1-46 (01 

5. Minimum number of sessions . 

6. Display informational messages? . Y,N Y^ 

Cmdl9-Cancel 


0-99,blank 

0S 


N 

/ 

. . 1-46 


. . 1-46 

,51) 

. . . Y,N 
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1. Host name: This entry is optional. You use it to specify the name of the host 
system for this remote location. If you do not specify a name, MSRJE 
accepts any application name when MSRJE is started. If you specify a name, 
MSRJE is started only if the name you specify matches the application name 
received from the host system. 

The name you specify must match: 

• The APPLID parameter (if used) in the LOGON command 

• The label on the VTAM APPL definition statement of the VTAM 
application definition 

• The following, based on the subsystem: 

— For JES2, the APPLID subparameter of the LOGON 1 initialization 
parameters 

- For JES3, the APPLID parameter of the COMMDEFN macro 
— “ F° r RES, the APPLID parameter of the RTAM macro 

- For VSE/POWER, the third positional subparameter of the SNA 
parameter of the POWER macro 


2. Termination delay in minutes: Specify the length of time, in minutes, that 
MSRJE will remain active after all readers, printers, and punches have 
finished and the MSRJE console has been released. Valid values are 00 
through 99 or blank. If blank is specified, MSRJE will not terminate 
automatically and must be terminated by entering the MSRJE END utility 
control statement or using the DISABLE procedure command. 


'Note: Command key 7 ends the MSRJE console or reader at the display 
station, but the subsystem remains active. 
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3. Priority: Specify the priority level that is to be assigned to tasks activated by 
MSRJE. N (normal) is the default. All priority values correspond to your 
definitions of priority levels on the // ATTR OCL statement. The valid 
selections are: 

• H for high priority 

• N for normal job priority 

• M for medium priority 

• L for low priority 

The MSRJE console always has high (H) priority. 

For a description of the // ATTR OCL statement, see the System Reference 
manual. 

4. Maximum number of sessions: Specify the maximum number of logical unit 
sessions that can be active at one time with the host system defined for this 
MSRJE configuration. The number of sessions specified cannot exceed the 
number of logical units selected for MSRJE on display 14.0 during line 
member definition for this remote system. (See the manual Using System/36 
Communications ). 

The default is 01, and the maximum is 46. 

5. Minimum number of sessions: Specify the minimum number of LU sessions 
that should be active with the host system defined for this MSRJE 
configuration. If the number of active sessions drops below this number, an 
END utility control statement is simulated by MSRJE. Any MSRJE functions 
then active are allowed to terminate normally. If this number of sessions 
cannot be activated when MSRJE is started, MSRJE will not start. 

The default is 01, and the maximum is 46. 

6. Display informational messages?: If you specify Y (Yes) for this prompt, all 
MSRJE informational messages are displayed on the MSRJE console. These 
messages inform the MSRJE operator of local MSRJE activities. This prompt 
does not control messages received from the remote host system. 

Once you press the Enter key, display 35.0, which allows you to define the host 
system logon/signon information, is displayed. 
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Display 35.0 MSRJE Logon Attributes 



1. Is LOGON formatted?: Use of a formatted logon enables MSRJE to more 
accurately recognize logon failures. 

Specifying an N for this prompt indicates that you will enter the LOGON 
command for prompt 3. If you specify Y, prompts 4 through 6 are displayed 
after you press the Enter key. 

2. Should MSRJE send first LOGON?: This parameter is dependent on whether 
the host system is generated to require that System/36 send the first logon or 
whether the host system will send the first logon. 

If you specify Y, MSRJE will send the logon to the host system when the data 
link is established. If you specify N, MSRJE will wait for the host system to 
send the first logon. 

If you specify N for this prompt, you may still have to enter the logon 
information for prompt 3 (unformatted logon) or prompts 4 through 6 
(formatted logon). 

• If you specify Y here, you must enter the logon information 

• If you specify N here, then: 

— If you specified a value greater than 1 for prompt 4 on display 34.0, 
you must enter logon information. 

— If you specified 1 for prompt 4 on display 34.0, you do not have to 
specify the logon information. 
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The host system determines whether to receive or send the first logon as 
follows: 



For JES2, the host system: 

— Receives the first logon if you specified A=N on a $T RMTnnn 
command entered at the host system before using MSRJE. You 
should specify Y for prompt 2 on display 35.0. 

— Sends the first logon if you specified A=Y on a $T RMTnnn 
command entered at the host system before using MSRJE. You 
should specify N for prompt 2 on display 35.0. 

Note: You can enter a $T RMTnnn command at the System/36 MSRJE 
console. It will take effect the next time you begin communicating 
with the host system. 

For JES3, the host system: 

— Receives the first logon if you specified N for the AUTO parameter 
of the RJPWS statement on the JES3 work station definition. You 
should specify Y for prompt 2 on display 35.0. 

— Sends the first logon if you specified Y for the AUTO parameter of 
the RJPWS statement on the JES3 work station definition. You 
should specify N for prompt 2 on display 35.0. 

For RES, the host system: 

— Receives the first logon if you specified 0 for the PLGN parameter 
on the TERMINAL macro during RTAM generation. You should 
specify Y for prompt 2 on display 35.0. 

— Sends the first logon if you specified 1 for the PLGN parameter on 
the TERMINAL macro for the RTAM generation. You should 
specify N for prompt 2 on display 35.0. 

For VSE/POWER, the host system always receives the first LOGON 

command. You should specify Y for prompt 2 on display 35.0. 
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3. Enter host LOGON/SIGNON command below: Specify the LOGON or 
SIGNON command that is required by the host system with which this 
MSRJE configuration will be communicating. Refer to the host system work 
sheet or contact the host system personnel for the exact logon or signon 
requirements. While the host system may define a special format for the 
logon, the general format of the logon is: 

/yt • * / ^ 

LOGON APPLID(application name)[LOGMODE(modename)] 

[DATA(any data)] 

The value for the APPLID parameter is normally specified as follows: 

• For JES2, use JES2 

• For JES3, use JES3 

• For RES, use RTAM 

• For VSE/POWER, use POWER 

The value entered for the LOGMODE parameter, if used, specifies the name 
of an entry in a table at the host system that contains the operating 
parameters for SNA communications. You should obtain the name of the 
LOGMODE entry from the host system work sheet or from the host system 
personnel. The table that contains the entry specified is selected by the 
MODETAB parameter of the PU macro during NCP/VTAM generation at 
the host system. The table itself is defined using the MODEENT macro. 

The value entered for the DATA parameter is based on the type of host 
system, as follows. 

. JES2 

DATA(RMTnnn [,password1] [,password2]) 

The RMTnnn parameter specifies the terminal number of System/36 as 
specified in the RMTnnn parameter of the host system’s remote terminal 
description. 

passwordl parmeter is optional and, if specified, is 1 through 8 alphameric 
characters and must match the password specified for the PASSWORD 
subparameter of the LINEnnn parameter during the definition of a remote 
work station for JES2 at the host system. 

The password2 parameter is optional and, if used, is 1 through 8 
alphameric characters and must match the value specified for the 
PASSWORD parameter of the RMTnnn parameter during remote work 
station definition for JES2 at the host system. 
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JES3 


DATA(wsname,password) 

The wsname parameter must match the value specified for the N 
parameter in the RJPWS statement during JES3 generation at the host 
system. 

The password parameter must match the value specified for the P 
parameter in the RJPWS statement at the host system. 

. RES 

U 

DATA ( 'userid[ /password] TERM(termid) [ PROC (procname) ] 



S7909009-0 

The userid parameter identifies System/36 to the host system, and must 
match the value specified at the host system for the ADD subcommand of 
the ACCOUNT command. 

The password parameter is optional and, if used, must be 1 through 8 
alphameric characters and must be separated from the userid parameter by 
a slash (/). In addition, the value must match the entry made in the ADD 
| subcommand for the specified user ID. 

The TERM(termid) or T(termid) parameter specifies the terminal 
identification number and must match the value entered for the TERMID 
parameter for System/36 in the TERMINAL macro for the RTAM 
generation at the host system. 

The PROC(procname) parameter allows you to specify a catalogued 
procedure (procname) at the host system that is to be executed as a part of 
the logon process. 

The NOTICES parameter, the default, allows you to specify that all 
general notices from the host system are to be listed automatically after 
logon. NONOTICES inhibits the listing of notices. 

The MAIL parameter, the default, allows you to specify that all messages 
directed to your terminal be automatically listed after logon. NOMAIL 
inhibits the listing of messages. 
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VSE/POWER 

DATA('remid[,password][,user information] 1 ) 


The remid parameter identifies the remote ID assigned to System/36 
during VSE/POWER generation at the host system. It must match the 
value specified for the REMOTE parameter in the PRMT statement 
during VSE/POWER generation. 

The password parameter, if used, is 1 through 8 alphameric characters and 
must match the value specified for the PSWRD parameter of the PRMT 
statement. 

The user information, if used, can be up to 16 bytes of data. Ask the host 
system personnel whether this information is needed. 

Note: The host system may have specified a different logon format than those given 
here. Contact host system personnel to determine the correct format of the 
logon. 

Because the example is for communicating with RES, the value entered is: 

LOGON APPLID(RTAM) LOGMODE(S36MSRJE) DATA('AO T(5) PROC(FSPROC)') 
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If you specified Y for prompt 1, display 35.0 is updated to include three more 
prompts. 



MSRJE LOGON ATTRIBUTES 


Remote system SNAHOST1 Remote location SNALOC1 


1. Is LOGON formatted?.Y,N 

2. Should MSRJE send first LOGON? . Y,N 


SNASUB1 W1 


4. Application ID 

5. Mode Name . . 

6. Data 


Eta/A 


Cmdl9-Cancel 




4. Application ID: Normally specified as follows: 

• For JES2, use JES2 

• For JES3 f use JES3 

• For RES, use RTAM 

• For VSE/POWER, use POWER 

You should refer to the host system work sheet or contact the host system 
personnel to verify the entry you should make here. 

5. Mode Name: The value entered for this prompt, if used, specifies the name of 
an entry in a table at the host system that contains the operating parameters 
for SNA communications. The table that contains the entry specified is 
specified by the MODETAB parameter of the PU macro during NCP/VTAM 
generation at the host system. The table itself is generated using the 
MODEENT macro. 

6. Data: Allows you to specify up to 60 characters of data that is to be 
submitted with the logon. 

See the description of the DATA parameter in prompt 3 for a description of 
the valid entries. 

After you press the Enter key, you define the MSRJE environment by completing 
the information on the next two displays. 
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Display 36.0 MSRJE Printer/Punch Attributes 




1. Forms control table name: Specify the name of the forms control table that is 
to be used with this MSRJE configuration to control the handling of print and 
punch data streams received from the host system. The forms control table is 
created by the MSRJE forms control table utility (see Chapter 5 for 
information on the forms control table utility). 

If you do not specify a name for this prompt, MSRJE handles print and punch 
data streams as described in the “Print Default Entry” and “Punch Default 
Entry” sections of Chapter 5. 

2. Forms set: Define the use of the internally maintained forms set table. The 
table contains entries for all print and punch devices supported by MSRJE. 
Use of the table allows MSRJE to remember the forms mounted for each 
device from LOGOFF of one session to LOGON of another session. This is 
useful if the host system views System/3 6 as the type of device that keeps the 
same form mounted all the time. 

Valid entries are 0 through 8; 0 is the default. If 0 is specified, MSRJE will 
not maintain a forms set table for this location and, therefore, will not 
maintain the forms names between sessions. Because the table can contain 
the definitions of forms for up to eight separate host systems, the value 
entered here defines which set you want used when this configuration is 
active. 

If the same forms set (other than 0) is specified in different MSRJE 
configurations, unexpected results may occur. 

Note: Initially , the forms name for all devices of all forms sets is all blanks . 

Cl If the host system is generated to use Peripheral Data Information Records 
^ (PDIRs), specify 0 because the host system will always send forms names. 
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3. Maximum number of printers: Specify the maximum number of printer tasks 
that can be active. Enter a value from 0 through 15; the default is 01. This 
value should be at least as large as the number of printers specified at the host 
system for this MSRJE configuration. 

The value for the number of printers is specified at the host system as 
follows: 

• JES2, specified in the NUMPR subparameter of the RMTnnn parameter 
on the JES2 work station definition 

• JES3, specified in the PR subparameter of the RJPWS parameter on the 
JES3 work station definition 

• RES, specified in the PTRS parameter of the TERMINAL macro for the 
RTAM stage 1 generation 

• VSE/POWER, 0 through 3, depending on whether you expect print 
output 

If the host system work sheet has been filled out, refer to it for the correct 
value. If you are configuring MSRJE before the host system is generated, 
enter the Maximum number of printers on the work sheet. 


4. Printer file sequence number: Specify a number from 01 through 99 to define 
the beginning sequence number for print files written to disk. See Chapter 3 
for a description of print output, and see Chapter 5 for a description of the 
forms control table entries that control print data written to disk. 
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5. Maximum number of punches: Specify the maximum number of punch tasks 
that can be active. Enter a value from 0 through 15; the default is 01. This 
value must be at least as large as the number of punches specified at the host 
system for this MSRJE configuration. 

The value for the number of punches is specified at the host system as 
follows: 

• JES2, specified in the NUMPU subparameter of the RMTnnn parameter 
on the JES2 work station definition 

• JES3, specified in the PU subparameter of the RJPWS work station 
definition parameter 

• RES, specified in the PCHS parameter of the TERMINAL macro for the 
RTAM stage 1 generation 

• VSE/POWER, always 0 or 1, depending on whether you expect punch 
output 

If the host system work sheet has been filled out, refer to it for the correct 
value. If you are configuring MSRJE before the host system is generated, 
enter the Maximum number of punches on the work sheet. 

6. Punch file sequence number: Specify a number from 01 through 99 to define 
the beginning sequence number for punch files written to disk. See Chapter 3 
for a description of punch output, and see Chapter 5 for a description of the 
forms control table entries that control punch data written to disk. 

The entries on display 36.0 define the printers and punches used for MSRJE. Once 
you press the Enter key, the last display, display 37.0, is presented. Display 37.0 
allows you to define the readers used by MSRJE and defined at the host system. 
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Display 37.0 MSRJE Reader Attributes 


r 


37.0 


MSRJE READER ATTRIBUTES 


SNASUB1 


Remote system SNAHOST1 Remote location SNALOC1 


1. Maximum number of MSRJE readers.1-32 01 

2. Maximum number of host readers.1-15 01 

3. Transparency?.Y,N N 

4. Specify default value for TYPE . P,D,S P 

5. Specify default value for CMD.Y,N Y 

6. Specify default value for DEL.Y,N N 




Cmd19-Cancel 

_ J 


1. Maximum number of MSRJE readers: Specify the number, from 1 through 
32, of readers that can be active at one time for this MSRJE configuration. 
The default is 1. 

By specifying a value that is greater than the value specified for the Maximum 
number of host readers prompt, you can start MSRJE readers and then allow 
them to wait for a host reader to become available. 

The number of readers that you specify here depends on your RJE 
environment. For example, if several users will be signing on to MSRJE and 
sending data files to the host subsystem, you would want to specify as many 
readers as you expect users to be signed on at one time. If all the host readers 
(prompt 2, Maximum number of host readers) are in use, MSRJE will hold 
additional reader requests and start a reader when a host reader becomes 
available. The user does not have to wait and then re-enter a request to start 
a reader. 
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2. Maximum number of host readers: Specify the maximum number of readers 
that can be sending data to the host system at one time. The value entered 
can be from 1 through 15; the default is 01. This value should not exceed the 
number of readers specified for the host during host system configuration. 

The maximum number of readers is specified at the host subsystems as 
follows: 

• JES2, specified in the NUMRD subparameter of the RMTnnn parameter 
on the JES2 work station definition 

• JES3, specified in the RD subparameter of the RJPWS statement for the 
JES3 work station definition 

• RES, specified in the RDRS parameter of the TERMINAL macro for the 
RTAM stage 1 generation 

• VSE/POWER, always 1 

3. Transparency?: Specify whether text transparency can be used with this 
MSRJE configuration. N, the default, specifies that text transparency cannot 
be used. Y specifies that text transparency can be used. 

Transparency is normally used if you will be sending and receiving data that 
contains data characters which could be handled as SNA Character String 
(SCS) control characters. Normally, this occurs in object modules or binary 
data streams. 

4. Specify default value for TYPE: Specify the default value to be used for the 
TYPE parameter on the MSRJE procedure or in READFILE utility control 
statements entered when this configuration is active. Specifying a value here 
is useful if most MSRJE procedure statements or READFILE utility control 
statements you use will have the same TYPE parameter value. Refer to 
“Starting an MSRJE Session” in Chapter 3 or “READFILE Utility Control 
Statement” in Chapter 4 for a complete description. 

Valid entries are: 

• P for a procedure member 

• D for a disk file 

• S for a source member 
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5 . 


Specify default value for CMD: Specify the default value to be used for the 
CMD parameter on the MSRJE procedure or in READFILE utility control 
statements entered when this configuration is active. Y indicates that the file 
contains utility control statements; N indicates that the file does not contain 
utility control statements. 

Specifying a value here is useful if most MSRJE procedure statements or 
READFILE utility control statements you use will have the same CMD 
parameter value. Refer to “Starting an MSRJE Session” in Chapter 3 or 
“READFILE Utility Control Statement” in Chapter 4 for a complete 
description. 

6. Specify default value for DEL: Specify the default value to be used for the 
DEL parameter on the MSRJE procedure or in READFILE utility control 
statements entered when this configuration is active. Y specifies that deleted 
records in the file are to be transmitted to the host system. N specifies that 
deleted records in the file are not to be transmitted to the host system. 

Specifying a value here is useful if most MSRJE procedure statements or 
READFILE utility control statements you use will have the same DEL 
parameter value. Refer to “Starting an MSRJE Session” in Chapter 3 or 
“READFILE Utility Control Statement” in Chapter 4 for a complete 
description. 

Once you have completed display 37.0, display 29.0 is again displayed, and you can 
then define another MSRJE configuration. To end the definition of MSRJE 
configurations, press command key 7. Display 1.0 is then presented, and you can 
either define another line or subsystem member, or end the CNFIGICF procedure 
by pressing command key 7. 
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Chapter 3. Running an MSRJE Session 


Enabling a Location for MSRJE 

Before you can run an MSRJE session, you must enable the desired MSRJE 
configuration. You defined the MSRJE configuration using the CNFIGICF 
procedure, as described in Chapter 2. A configuration consists of the subsystem 
member and the line member referenced in the subsystem member. To activate an 
MSRJE configuration, enter the ENABLE procedure command from any 
command-capable display station. The ENABLE procedure uses the information 
in the specified subsystem member, and its associated line member, to load and 
initialize the proper communications support (BSC or SNA) and to allocate the 
needed areas in storage. Once the ENABLE procedure has been run for an 
MSRJE configuration, MSRJE sessions can be started that use that configuration. 

The format of the ENABLE procedure is: 


ENABLE subsystem configuration name, 

library name 
current library 

, line number , 


NOSHOW 

, location name ^ ( 

/ * h/fyA/ L / 

SHOW 

L J ' ^ f ' CJ 


S9020113-0 


name: Specify the name of the MSRJE subsystem member that is to be enabled. 
You assigned this name on display 1.0 during the MSRJE subsystem 
configuration process. This parameter is required. 

For the examples in Chapter 2, the subsystem member name would be 
BSCSUB1 for the BSC MSRJE example, or SNASUB1 for the SNA MSRJE 
example. 
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library name: Specify the name of the library in which the configuration member 
specified for the name parameter is stored. If no entry is made, the current 
library is assumed. 

For both the BSC and SNA MSRJE examples in Chapter 2, the library is 
RJELIB. 

line number: Specify the communications line to be used by this configuration. 
Note that if the line definition within the line member does not match the 
physical characteristics of the line, a message is displayed giving you the 
option of canceling the enable request or using the line definition within the 
line member. This parameter is required. 

SHOW/NOSHOW: Specify whether you want to view the values set for the 
configuration. SHOW specifies that you do want to see the values. 
NOSHOW specifies that you do not want to see the values. 

location: Specify the name of the remote location that is to be enabled. This name 
must have been specified as a remote location name on display 30.0 during 
MSRJE subsystem configuration. 

If you specify a remote location in the ENABLE procedure command, only that 
location is enabled. If no location is specified, all locations for which Activate at 
ENABLE is specified (defined on display 30.0 during subsystem member 
configuration) are enabled. 

If N was specified for the prompt Activate location at ENABLE on display 30.0 
during subsystem member configuration, the ENABLE procedure command used 
for the BSC example shown in Chapter 2, would be: 

ENABLE BSCSUB1,RJELIB,1,,BSCLOC1 

If Y was specified for the prompt Activate location at ENABLE on display 30.0 
during subsystem member configuration, the ENABLE procedure command used 
for the SNA example in Chapter 2 would be: 

ENABLE SNASUB1,RJELIB,2 


3-2 Multiple Session Remote Job Entry Guide 



Starting an MSRJE Session 


t 

You can start (sign on to) an MSRJE session from any command-capable display 
station by entering the MSRJE procedure command. You can sign on to MSRJE 
and specify that a library member or disk file be automatically read once the data 
link is established; you can sign on as the MSRJE console, or you can sign on to 
MSRJE as a reader. In addition, you can sign on to MSRJE and immediately 
release the display station, which allows MSRJE to receive output from the host 
system. 


The format of the procedure command for signing on and specifying a library 
member to b e automatically rea dis^-— - 


PROC 

(P) 

SOURCE 

(S) 


• 


■ 


■ 


COMMAND 

DATA 

r 

DELETE 

NODEL 

t 

NOREL 

RELEASE 

CONSOLE 



S9020164-0 


MSRJE location name/ 

member name 

/ 

library name 

\ 



current library 


The format of the procedure command for signing on and specifying a disk file to 
be automatically read is: 
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If you want to sign on to MSRJE as the MSRJE console and not specify a file or 
member to be read, simply enter: 

MSRJE location,,,,,,CONSOLE 

If you want to sign a display station on to MSRJE and do not want it to be the 
console, enter: 

MSRJE location 

The first parameter lets you specify the host subsystem (remote location) with 
which you want to communicate. 

location: Specify the name of the remote location with which you want to 

communicate using this MSRJE session. You must have assigned this name 
during MSRJE configuration on display 30.0, and the specified remote 
location must have been previously enabled^ If the named remote location 
has not been both configured and enabled, a message is displayed, and the 
session will not be started. 

The next five parameters allow you to specify a disk file or library member that is 
to be automatically read when the MSRJE session is started. The file or member 
can contain a host job stream and/or MSRJE utility control statements. 

read-file-name: Specify the name of the disk file or library member that is to be 
read by an MSRJE reader once the session is started. If no value is specified, 
MSRJE assumes that input, if any, will come from the keyboard. 

library-name: Specify the name of the library that is to be searched for the member 
specified by the read-file-name parameter. If a library name is entered, only 
that library is searched for the member specified in the read-file-name 
parameter. If no library-name is entered and a library member was specified 
for the read-file-name parameter, the current library is searched for the 
member and, if the member is not found, the system library is searched. 

If the member cannot be found, a message is presented and you must enter 
the MSRJE procedure command again using the correct read-file-name and 
correct library-name values. 

This parameter applies only if parameter 4 is PROC, P, SOURCE, or S, or if 
parameter 4 is not specified and prompt 4 on display 37.0 (Specify default 
value for TYPE) was specified as P or S. 

date: Specify the creation date of the disk file specified for the read-file-name 
parameter that is to be read by MSRJE. If no date is specified, the named 
file with the latest creation date is read. The format of the date entry must be 
the same as the format of the system date. 

This parameter applies only if parameter 4 is DISK or D, or if parameter 4 is 
not specified and prompt 4 on display 37.0 (Specify default value for TYPE) 
was specified as D. 
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PROC or P: Specify that the read-file-name parameter is a procedure member. If 
no entry is made for this parameter, the default value specified for prompt 4, 
Specify default value for TYPE, on display 37.0 during configuration of the 
subsystem member is used. 

SOURCE or S: Specify that the read-file-name parameter is a source member. If 
no entry is made for this parameter, the default value specified for prompt 4, 
Specify default value for TYPE, on display 37.0 during configuration of the 
subsystem member is used. 

DISK or D: Specify that the read-file-name parameter is a disk file. If no entry is 
made for this parameter, the default value specified for prompt 4, Specify 
default value for TYPE, on display 37.0 during configuration of the subsystem 
member is used. 

COMMAND: Specify that the read-file-name disk file or member contains MSRJE 
utility control statements that are to be processed by MSRJE. 

If COMMAND is specifi ed and tran sparency was selected during MSRJE 
configuration (prompt 3, Transparency? on dispiay 37VQ during suFsystem 
^ member ronflgnrafio^ If 

you are going to use transparency with a file or member specified as 
COMMAND, you should be certain that there are no data streams within the 
file or member that match the binary representation of the characters .. 
(period period blank). If that sequence appears at the beginning of a record 
in a file or member specified as COMMAND, MSRJE attempts to process 
that record as a utility control statement. 

If no entry is made for this parameter, the default value specified for prompt 
5, Specify default value for CMD, on display 37.0 during configuration of the 
subsystem member is used. 

If COMMAND is specified, or if it is not specified and prompt 5 on display 
37.0 is specified as Y (Y indicates command; N indicates data), all records 
within the file or member must be 80 characters long. 

DATA: Specify that the file or member specified by the read-file-name parameter 
contains only data and JCL to be sent to the host system. If any MSRJE 
utility control statements are in a file or member specified as DATA, they are 
sent to the host system without being processed by MSRJE. 

If no entry is made for this parameter, the default value specified for prompt 
5, Specify default value for CMD, on display 37.0 during configuration of the 
subsystem member is used. 
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DEL: Specify that records marked as being deleted in direct or sequential files will 
be sent to the host system. 

This parameter applies only if the file is delete-capable and if parameter 4 is 
DISK or D, or if parameter 4 is not specified and prompt 4 on display 37.0 
(Specify default value for TYPE) was specified as D. 

If no entry is made for this parameter, the default value specified for prompt 
6, Specify default value for DEL on display 37.0 during configuration of the 
subsystem member is used (Y indicates delete-capable, N indicates not 
delete-capable). 

NODEL: Specify that records marked as deleted in direct and sequential files are 
not to be sent to the host system. 

This parameter applies only if the file is delete-capable and if parameter 4 is 
DISK or D, or if parameter 4 is not specified and prompt 4 on display 37.0 
(Specify default value for TYPE) was specified as D. 

If no entry is made for this parameter, the default value specified for prompt 
6, Specify default value for DEL on display 37.0 during configuration of the 
subsystem member is used (Y indicates delete-capable, N indicates not 
delete-capable). 

The last parameter allows you to designate the display station as the MSRJE 
console, or to release the display station from MSRJE once the session is started. 

RELEASE: Specify that the display station entering the MSRJE procedure is to be 
released (returned to System/36 as command-capable) after MSRJE has 
started. 

Specifying 

MSRJE location,,, ,,,RELEASE 

provides you with a means of starting MSRJE without a reader or the MSRJE 
console so that print or punch data can be received from the host system. 

NOREL: Specify that the display station entering the MSRJE procedure is to 
remain attached to MSRJE. This is the default value. 
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CONSOLE: Specify that the display station entering the MSRJE procedure will be 
the MSRJE console. If no other display station is signed on to MSRJE as the 
console, this display station becomes the console. If another display station is 
currently signed on as the console, then a message is displayed, and the 
program ends. 

If you are using the MSRJE procedure within another procedure, you should 
consider how this last parameter affects when the MSRJE procedure ends. The 
MSRJE procedure ends: 

• If you specify RELEASE, when MSRJE starts 

• If you specify NOREL, when the reader terminates 

• If you specify CONSOLE, when the session with the host ends or when you 
release the console 

Once you have entered the MSRJE procedure command, the following display is 
presented if you signed on as the MSRJE console (by specifying the CONSOLE 
parameter in the MSRJE procedure command). 


MSRJE Console 


Startup in progress 


S7909010-0 
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Once the startup has been completed, the MSRJE Console Input display is 
presented. If you signed on to MSRJE as the MSRJE console and specified a 
read-file-name value, then the Readfile in Progress display is presented once the 
startup has been completed. If MSRJE cannot be started or if there is an error in 
the MSRJE procedure command, a message is presented. 

If you signed on as a reader (that is, you did not specify CONSOLE in the MSRJE 
procedure command), the following display is presented: 


MSRJE Reader 


Startup in progress 


S7909011-0 
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If the startup is successful, the Reader Input display is presented if you signed on to 
MSRJE without specifying a read-file-name and without specifying CONSOLE. If 
you specified a read-file-name on the MSRJE procedure command, the Readfile in 
Progress display is presented. If the RELEASE parameter was specified on the 
MSRJE procedure command, the display station becomes command-capable. If an 
error occurs or if the session cannot be started, a message is displayed. 

If you press command key 19 while the Startup in Progress display is present, the 
display station is released, and the System/36 command display is presented. If the 
connection with the host system has not been completed when you press command 
key 19, the connection will not be made. If the connection has been established 
and a read-file-name parameter was specified on the MSRJE procedure command, 
that file or member is not read by MSRJE, and the display station is released. 
Command key 19 always terminates MSRJE. You can also press the Help key 
while the Startup in Progress display is present. 


Input to an MSRJE Session 

Input to MSRJE is of two types: console input and reader input. 

Console input allows you to act as a host system operator; that is, you can enter 
host system commands to display and control the jobs submitted through MSRJE. 
You can also enter MSRJE utility control statements, which are processed by 
MSRJE. See “Console Input” later in this chapter for more information. 

Reader input is the means by which you can send jobs to the host system. MSRJE 
sends job statements, either from a display station keyboard as you enter records or 
from a disk file or member that you have specified. MSRJE utility control 
statements can also be entered as reader input. See “Reader Input” later in this 
chapter for more information. 
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Console Input 


You can enter console input only from the display station you signed on as the 
MSRJE console. You do that by specifying the CONSOLE parameter in the 
MSRJE procedure. If no other station is signed on as the console, your display 
station becomes the MSRJE console. 

Console input is allowed only when the MSRJE Console Input display is present. 
The Console Input display appears as follows: 


MSRJE Console 


MSRJE Console Input 


S7909012-0 


The space between the two dashed lines on the Console Input display is used to 
display messages received from the host system and messages generated by 
MSRJE. You cannot enter data into that area. All console input is logged to the 
history file. Records consisting of all blanks are ignored when the Console Input 
display is present. To indicate the end of a record, press the Enter key after you 
have typed the record. 
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Console input is entered on lines 22 and 23 of the display, and each record entered 
can be up to 120 characters (a record ends when you press the Enter key). 

Console input can be MSRJE utility control statements or host system commands. 
The MSRJE utility control statements that can be entered are: 

• READFILE 
. LIBRARY 

• SETFORM 

• CANCEL 

• END 

See Chapter 4 for a description of the utility control statements. 

Entering a READFILE Utility Control Statement as Console Input 

If a READFILE utility control statement is entered as console input, the keyboard 
is locked (the Input Inhibited light is on) and you cannot enter data. If the 
READFILE statement is correct and a reader can be acquired, the keyboard is 
unlocked. You can then enter console input, change to reader mode, or release the 
console. When the reader begins sending data, the message ’RDxx Started’ is 
displayed in the message area. If MSRJE is waiting for a host reader to become 
available, no message is displayed until the reader actually sends data. If the reader 
needed could not be acquired or if the READFILE statement is in error, the 
appropriate message is displayed, and the keyboard unlocked. 

Once a reader is started from the console by the READFILE utility control 
statement, it is no longer associated with the console. When the reader completes 
processing, a message is displayed at the console indicating that the reader has 
ended. 
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Command Keys from the MSRJE Console 


When the Console Input display is present, the following command keys are 
available: 

• Command key 7 causes the System/36 command display to be presented 

• Command key 19 causes the System/36 command display to be presented 

• Command key 1 requests that a reader be started for the console (the Reader 
Input display is presented) 

The Help, Print, ATTN, and Dup keys can also be used while the Console Input 
display is present. 


Using the Dup Key 


You can use the Dup key to copy the last line of data you enter. 

You need only press the Dup key once to make a line (80 characters) of copied 
characters appear, but you must press it a second time to make an additional 40 
copied characters appear on the second input line. When you have the desired 
number of characters, press the Enter key to restore the data you last entered, 
whether it was 80 or 120 characters. Make any necessary changes. Then press the 
Enter key to process the data. Any data you enter is saved, unless you enter all 
blanks. 

If you press the Dup key followed by the Help key, the Help display appears. 

When you exit Help, the copied characters appear once again. If you press the Dup 
key followed by command key 1, the copied characters remain on the display. 

MSRJE can store up to 120 characters each time you press the Enter key if you 
enter the data as console input. MSRJE can store up to 80 characters if you enter 
the data as reader input. 

Note: You can enter more than 80 characters as console input , press command key 1 
to get the Reader Input display , and then enter reader input. However , when 
you try to recall your last line of console input from the Console Input display , 
the 80 characters of reader input appears along with 40 blank characters. You 
get the last data you entered , whether it was reader or console input. 
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Reader Input 


An MSRJE reader starts when you enter the MSRJE procedure command from a 
display station without specifying CONSOLE or when a read-file-name is specified 
on the procedure command. You can also activate a reader from the MSRJE 
console by pressing command key 1. 

If no MSRJE reader is available (the number specified by the Maximum number of 
MSRJE readers prompt on display 37.0 during subsystem configuration has been 
exceeded), a message is displayed telling you that a reader cannot be started. If the 
request for a reader was made from a display station other than the MSRJE 
console, the program ends, and the display station is released. If the request for a 
reader was made from the MSRJE console, you can return to the MSRJE Console 
Input display by selecting option 0 in response to the message. 

If no active session is available (the Maximum number of sessions value specified on 
display 34.0 during configuration of a subsystem for SNA MSRJE has been 
exceeded) or if no host reader is available (the value specified for the Maximum 
number of host readers prompt on display 37.0 during subsystem configuration has 
been exceeded), a message is displayed telling you that all sessions or host readers 
are in use. 

If MSRJE determines that there are no host readers available (a negative response 
from the SNA host system for all configured host readers; no response within 
60-seconds from a BSC host system for all configured host readers), a message is 
sent to the console (if active) to inform you that a START command may need to 
be sent to the host system. You should select option 0 in response to the message, 
and then send the command(s) to start the host readers. 

If you select option 1 in response to the displayed message that tells you all 
sessions or host readers are in use, MSRJE will keep your request for a reader 
active and wait for one to become available. The following display is presented: 
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MSRJE Console or MSRJE Reader 


Waiting for a reader 


S7909013-0 


If you choose any other option in response to the displayed message, MSRJE takes 

one of the following actions: 

• Option 0 (only if you requested a reader from the MSRJE console): Return to 
the Console Input display. The request for a reader is terminated. 

• Option 2: Return to the System/36 command display. The request for a 
reader is terminated. 

While the Waiting for a reader display is present, the following command keys are 

valid: 

• Command key 1 return to console input, if your display station is the MSRJE 
console. 

• Command key 7 return to the System/36 command display. If you specified a 
read-file-name on either the MSRJE procedure command or on a READFILE 
utility control statement, MSRJE sends that file when a reader becomes 
available. 

• Command key 19 return to the System/36 command display. The request for 
a reader is terminated, and no data is sent. 
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The Help, ATTN, and Print keys can also be used while this display is present. 


A reader terminates at a display station when you enter an EOF utility control 
statement, or when an EOF utility control statement is processed in a file or 
member that you specified as containing MSRJE utility control statements (using 
the COMMAND parameter on the MSRJE procedure command or by specifying 
CMD-Y on a READFILE utility control statement). 

If you terminate the reader at a display station, the MSRJE session is terminated, 
and you can enter commands at the display station. If you terminate a reader at 
the MSRJE console, the Console Input display appears. 
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Display Station Input to a Reader 


The MSRJE Reader Input display is presented if an MSRJE reader, an LU session 
(SNA MSRJE only), and a host reader are available when you press command key 
1 at the MSRJE console or when you enter an MSRJE procedure command 
without specifying a read-file-name , CONSOLE, or RELEASE. The Reader Input 
display appears as follows: 


i 


\ 


MSRJE Console or MSRJE Reader 


MSRJE Reader Input 


S7909014-0 


The space between the dashed lines on the display is used as a display area for 
reader messages. Input to a reader can only be entered on line 22 of the display. 

You can enter data, JCL statements, and certain utility control statements 
(READFILE, SETFORM, LIBRARY, EOF, and END) to MSRJE from the 
display station. The records you enter can be up to 80 characters in length. End 
each record by pressing the Enter key. Utility control statements entered are 
logged to the history file. 

If your display station is the MSRJE console, pressing command key 1 returns you 
to the MSRJE Console Input display with the message Reader Active displayed. 

Pressing command key 7 while the Reader Input display is present returns the 
display station to the System/36 command display. 

Pressing command key 19 while the Reader Input display is present returns the 
display station to the System/36 command display. 

The Help, Print, ATTN, and Dup keys can also be used. 
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Using the Dup Key 


You can use the Dup key to copy the last line of data you enter. 

Simply press the Dup key, then the Enter key to make your last line of data appear 
in the input area. Make any necessary changes. Then press the Enter key a second 
time to process the data. Any data you enter is saved, unless you enter all blanks. 

If you press the Dup key followed by the Help key, the Help display appears. 

When you exit Help, the copied characters appear once again. If you press the Dup 
key followed by command key 1, the copied characters remain on the display. 

Note: If you enter data as console input, you can press command key 1 to get the 
Reader Input display. If you press the Dup key and then the Enter key, the 
first 80 characters of your console input appears. You always get the last input 
you entered, whether it was reader or console input. 
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Disk Input to a Reader 


You request disk input to an MSRJE reader by specifying the read-file-name 
parameter on the MSRJE procedure command when you start MSRJE or by using 
the READFILE utility control statement. When the disk is to be used for input, 
you can specify: 

• The name of the file or library member to be read 

• Whether the file or library member contains MSRJE utility control statements 

• Whether the input is from a disk file, procedure member, or source member 

• The creation date of a disk file 

• The name of the library to be searched for a procedure or source member 

• Whether deleted records are to be transmitted to the host system from a direct 
or sequential disk file 

Note: All disk files are read sequentially. Therefore , the same data is sent to the 
host system whether you specify the name of a parent file or of an alternative 
index file as the read-file-name. 

For a more complete description of disk specifications, see “READFILE Utility 
Control Statement” in Chapter 4, or see “Starting an MSRJE Session” earlier in 
this chapter for a discussion of the MSRJE procedure command. 
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If you enter a READFILE utility control statement from the display station or 
specify the read-file-name parameter on the MSRJE procedure control statement, 
the reader begins processing the file or member specified. You cannot enter data 
until the reader completes processing the file or member. While the reader is 
processing the file or member, the following display is presented: 


MSRJE Reader or MSRJE Console 


MSRJE READFILE in progress 


S7909015-0 


The area between the dashed lines is to display reader or console messages or to 

display messages generated by MSRJE or the host system. The only keys 

permitted are: 

• The ATTN key (to suspend the reader). 

• If your display station is the MSRJE console, pressing command key 1 returns 
you to the Console Input display with the message Reader Active displayed. 

• Command key 7, which causes the System/36 command display to be 
presented (the reader continues reading the file or member). 

• Command key 19, which terminates the reader and causes the System/36 
command display to be presented. 

• Help and Print keys. 
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Once processing of the file has completed, a message is displayed at the display 
station indicating that processing of the file has completed and that the reader is 
available for input from the display station. 

Files or library members used as input to MSRJE can contain only data to be sent 
to the host system, or they can contain data for the host system and utility control 
statements. (The utility control statements are processed by MSRJE and not sent 
to the host system.) The data sent to the host system can be JCL and data. The 
utility control statements that can be in a file are READFILE, SETFORM, 
LIBRARY, END, and EOF. If the file you specify as input to MSRJE contains 
utility control statements, you must define it as such to MSRJE by specifying one 
of the following: 

• COMMAND on the MSRJE procedure command (only if you specify a 
read-file-name on the command). 

• CMD-Y on the READFILE utility control statement. 

• Y for the Specify default for CMD prompt on display 37.0 during subsystem 
configuration and then not specifying either the CMD parameter on a 
READFILE utility control statement or the MSRJE COMMAND parameter 
on the MSRJE procedure command. 

All records sent to the host system by an MSRJE reader are sent as 80-character 
records, regardless of the actual length of the records within the file or member. 
For example, a file containing four 60-character records is sent to the host system 
as three 80-character records. A file containing four 120-character records is sent 
to the host system as six 80-character records. If necessary, the application 
program that is to process the data at the host system must return the received 
records to their original length. Note, however, that files or members specified as 
containing utility control statements must have a record length of 80 characters. 
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Output from MSRJE 


Output from an MSRJE session can consist of one, all, or any combination of the 
following: 

• Print data from the host system 

• Punch data from the host system 

• Operator messages from the host system 

• Operator messages generated by MSRJE 

Note: You cannot use OCL statements to produce MSRJE output. 


Print Data from the Host System 

When print data is received from the host system, MSRJE can do any of the 
following: 

• Write the print data to a System/36 printer. 

• Print up to 198 positions when you are using a forms control table with a 
CPI=15 or a print wheel ID, which has a CPI=15. 

• Write the print data to the System/36 spool file. 

• Create a new sequential file and write the print data to the file as 
256-character unprocessed records. 

• Add the print data to an existing sequential file of 256-character unprocessed 
records (this file can contain both print and punch data). 

The destination of print output received from the host system is controlled by a 
forms control table. When you configured MSRJE for the location specified in the 
MSRJE procedure command, you may have specified the name of a forms control 
table that is to control print output received from the host system. The forms 
control table name is specified on display 36.0 during MSRJE subsystem 
configuration. You can create forms control tables by using the RJTABLE 
procedure command, as described in Chapter 5. If you do not create any forms 
control tables, IBM-supplied default values for print output will be used. These 
default values are supplied with MSRJE and are shown in Appendix D. 

While MSRJE is being initialized (after the MSRJE procedure has been entered), a 
check is made to determine whether the forms control table specified (on display 
36.0 during subsystem member configuration) is usable. If the table cannot be 
found or is not usable, a message is displayed giving you the option of terminating 
MSRJE or of continuing and using the IBM-supplied default values for print 
output. 
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When print output is received from the host system, it is usually preceded by a host 
forms name. When MSRJE receives that host forms name, it searches the specified 
forms control table, if any, for an entry with the same name. If a matching entry is 
found, the information in that table entry is used to control forms and print 
operations, or to control creating and writing of disk files. If no matching entry is 
found, the default print output entry in the specified table is used. If no host forms 
name is received with the data, MSRJE uses the name from the previous output. If 
no forms control table was specified on display 36.0 during configuration, the 
IBM-supplied print output default values are used. The forms control table and the 
forms control table utility are described in Chapter 5. The IBM-supplied default 
values are shown in Appendix D. 

If print output is written to the System/36 spool file, the spool file PRINTER name 
will be one of the following: 

• The host job name, if one is sent by the host subsystem and the name is 
nonblank 

• The host forms name, if one is sent by the host subsystem and the name is 
nonblank 

• The local forms name, if nonblank 
. MSRJE 

Print output written to disk is written to a compressed file (a file with 
256-character unprocessed records—unprocessed records are written exactly as 
they are received). The RJFILE procedure command can be used to print these 
files. 

Print output written to a disk file is labeled by MSRJE using the print file sequence 
number (as defined on display 36.0 during MSRJE configuration) and the file label 
from the matching forms control table entry. If there is no matching entry in the 
forms control table, the print default entry is used. If there is no forms control 
table, the IBM-supplied print default values are used. The format of the label 
created by MSRJE is: 

xxxxxxnn 

where 

xxxxxx is the file label from the control table entry or MSRJE 

nn is the printer file sequence number if ADD-NO is specified in the control 
table. 

or 

nn is 00 when ADD-YES is specified in the control table entry. 

Note: ADD-YES specifies that the received print data is to be written to an existing 
file (the new data is written after any data already in the file). If ADD-YES 
is specified and a file named xxxxxxOO does not exist, MSRJE creates that 
file and then writes the received print data to it. ADD-NO specifies that the 
data is to be written to a new file that is created when needed by MSRJE. 
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Whenever a file is created using the print file sequence number, the number is 
increased by 1 for all files except the first file created. For example, if you had 
specified 10 for the print file sequence number on display 36.0 during 
configuration, the first file would be xxxxxxlO, and the next file would be 
xxxxxxll. 

The maximum value for the sequence number is 99. If the last file created were 
xxxxxx99, the next file created would be xxxxxxOl. 

To take full advantage of the forms control table functions, you should note the 
following: 

• For SNA MSRJE, the host system should send Peripheral Data Information 
Records (PDIR) and forms names should be specified in the JCL. The sending 
of PDIRs by the host system is specified at the host during system generation. 

• For BSC MSRJE, the host system should send forms mount messages, and 
forms name should be specified in the JCL. 

If forms mount messages or PDIRs are not sent by the host system, MSRJE uses 
the last forms name received by the printer or the forms name that was saved in the 
forms set member for the printer. 

Punch Data from the Host System 

When punch data is received from the host system, MSRJE can do any of the 
following: 

• Create a new disk file and write the punch data to it. 

• Add the punch data to an existing file. 

• Create a new sequential file and write the punch data to disk as 256-character 
unprocessed records. 

• Add the punch data to an existing sequential file of 256-character unprocessed 
records (this file can contain both print and punch data). 

The destination of punch output received from the host subsystem is controlled by 
a forms control table. When you configured MSRJE for the location specified in 
the MSRJE procedure command, you may have specified the name of a forms 
control table that is to control output received from the host system. The forms 
control table name is specified on display 36.0 during MSRJE subsystem 
configuration. You can create forms control tables by using the RJTABLE 
procedure command, as described in Chapter 5. If you do not specify a forms 
control name during subsystem member configuration (on display 36.0), the 
IBM-supplied default values for punch output are used. These default values are 
shown in Appendix D. 
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When punch output is received from the host system, it is usually preceded by a 
tSsTforms^ name, it searches the speci fiedf forms 

control table, if any, for an entry with the same name . If a matching entry is found, 
The mroraTation in th^T^^ ^^^s^^tocontrol creatmgltn^^ 
tilSsTnnrrioTnatcKmg^entry is found, the default punch output entry in the specified 
“table is used. If no host forms name is received with the data, MSRJE uses the 
name from the previous output. If no forms control table was specified on display 
36.0 during configuration, MSRJE uses the IBM-supplied punch output default 
values. The forms control table and the forms control table utility are described in 
Chapter 5. The IBM-supplied default values are shown in Appendix D. 

Punch output directed to a disk file or to a compressed disk file is labeled by 
MSRJE using the punch file sequence number (as defined on display 36.0 during 
MSRJE configuration) and the file label from the matching forms control table 
entry. If there is no matching entry in the table, the punch default entry is used. If 
there is no forms control table, the IBM-supplied defaults for punch data, as shown 
in Appendix D, are used. The format of the label created by MSRJE is: 

xxxxxxnn 

where 

xxxxxx is the file label from the control table entry or MSRJE 

nn is the punch file sequence number if ADD-NO is specified in the control 
table. 

or 

nn is 00 when ADD-YES is specified in the control table entry. 

Note: ADD-YES specifies that received punch data is to be written to an existing file 
(the new data is written after any data already in the file). If ADD-YES is 
specified and file xxxxxxOO does not exist, MSRJE creates that file and then 
writes the punch data to it. ADD-NO specifies that the data is to be written to 
a new file that is created when needed by MSRJE. 

Whenever a file is created using the punch file sequence number, the number is 
increased by 1 for all files except the first file created. For example, if you had 
specified 10 for the punch file sequence number on display 36.0 during 
configuration, the first file would be xxxxxx 10, and the next file would be 
xxxxxxll. 

The maximum value for the sequence number is 99. If the last file created were 
xxxxxx99, the next file would be xxxxxxOl. 
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To take full advantage of the forms control table functions, you should be aware of 
the following: 

• For SNA MSRJE, the host system should send Peripheral Data Information 
Records (PDIR), and forms names should be specified in the host system JCL. 
The sending of PDIRs by the host is specified at the host system during system 
generation. 

• For BSC MSRJE, the host system should send forms mount messages, and 
forms name should be specified in the host system JCL. 

If forms mount messages or PDIRs are not sent by the host system, MSRJE uses 
the last forms name received by the punch, or the forms name that was saved in the 
forms set member for the punch. 


Operator Messages from the Host System 

Operator messages from the host system received by MSRJE are written to the 
history file. If the MSRJE console is active when a message is received from the 
host system, the message is also displayed at the console. 

Operator Messages from MSRJE 

Messages to the operator from MSRJE are handled as follows: 

• All messages are logged to the history file. 

• Reader messages are displayed at the display station that started the reader, 
unless the display station has been released. 

• Readers started from the MSRJE console while in console input mode display 
only those messages that indicate the reader has started or ended. 

• Messages from MSRJE relating to console input are displayed at the MSRJE 
console. 

• Printer and punch messages are displayed at the console if the console is active. 

MSRJE supports the System/36 //NOHALT capability. If a halt message is 
directed to a display station, it is automatically responded to, but not displayed, if 
the system NOHALT criteria are met. Refer to the System Reference manual for a 
description of the NOHALT capability. 

If a halt message is directed to a display station that has been released from 
MSRJE, the message is logged to the history file, and the default response is always 
taken. 

You can modify the default responses for MSRJE messages in the same manner as 
you can modify the default responses for other system messages. MSRJE messages 
are stored in the system message member (##MSG1). Refer to the System 
Reference manual for more information. 
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Ending an MSRJE Session 


You can end (sign off) MSRJE at your display station and yet leave the MSRJE 

connection with the host system intact. To end MSRJE for your display station, 

use one of the following methods: 

• Press command key 7 to release the display station from MSRJE. If the 
Readfile in Progress display is present, MSRJE continues to process that file. 

If the Waiting for a reader display is present when you press command key 7, 
the display station is released, but MSRJE continues to wait for a reader to 
become available if you have entered a READFILE utility control statement or 
specified a read-file-name on the MSRJE procedure command. 

• Press command key 19 to release the display station from MSRJE and to 
immediately end the processing of any reader input for your display station. 

• Specify option 2 for any reader or console message; this option has the same 
effect as pressing command key 19. Note that specifying option 2 for a print 
or punch message has no effect on the display station. 

• A CANCEL utility control statement entered from the MSRJE console that 
specifies the reader active at your display station has the same effect as 
pressing command key 19 unless your display station is signed on as the 
MSRJE console. 

• A system operator cancel command that references the job active for your 
display station has the same effect as pressing command key 19. 

• Enter an EOF utility control statement when the Reader Input display is 
present. 

None of the preceding methods has any effect on the MSRJE connection with the 

host system. 
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Ending the MSRJE Connection with the Host System 

The connection with the host system is normally terminated when an END utility 
control statement is processed. After an END statement has been entered, no new 
readers can be started. Once all readers, printers, and punches have completed 
processing, if a delay value has been specified, MSRJE waits the specified length of 
time. If the time elapses, normal shutdown begins. If a printer or punch is started 
before the time elapses, MSRJE remains active. Once the printer or punch has 
completed processing, MSRJE will again begin waiting for the specified length of 
time. If the DELAY value specified on the END utility control statement is 0 or if 
no delay value has been specified, MSRJE begins shutdown as soon as all readers, 
printers, and punches have completed. The connection can also be ended by any 
of the following: 

• Specify a termination delay value (on display 34.0 during subsystem member 
configuration). This value is similar to the delay value on an END utility 
control statement, except that it does not take effect until all readers, printers, 
and punches are inactive, and the MSRJE console has been released. 

• Enter a DISABLE procedure command that specifies the active MSRJE 
subsystem. 

• Stop or restart the communications line at the host system (BSC only). 

• Vary inactive the line, physical unit, or logical units at the host system (SNA 
only). 
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Disabling an MSRJE Remote Location 


The subsystem used by MSRJE is terminated when you enter a DISABLE 
procedure that specifies the subsystem configuration member name. The format of 
the DISABLE procedure is: 


DISABLE 


subsystem configuration name, 


location name 


S9020109-0 


subsystem-configuration-name: Specify the name of the MSRJE subsystem that is 
to be terminated. This is the same value specified for the ENABLE 
procedure when the subsystem was activated. 

In the SNA example in Chapter 2, the name would be SNASUB1; for the 
BSC example, it would be BSCSUB1. 

location name: Specify the name of the remote location that is to be disabled. The 
name specified here should correspond to the location specified on the 
MSRJE procedure command. If no remote location name is specified, all 
enabled locations in the specified subsystem-configuration are disabled. 

To disable the remote location for the BSC example in Chapter 2, the 
procedure command would be: 

DISABLE BSCSUB1,BSCLOC1 

To disable all enabled remote locations in BSCSUB1, the format would be: 
DISABLE BSCSUB1 

For the SNA example, the format of the procedure command is: 

DISABLE SNASUB1,JES2LOC 
or 

DISABLE SNASUB1 

If MSRJE is logged on to the host system when the DISABLE procedure command 
is entered, a message is displayed indicating that there are active sessions. The 
message allows you to pend the DISABLE (option 0), retry the DISABLE (option 
1), force an immediate DISABLE (option 2), or cancel the DISABLE procedure 
(option 3). 

If the DISABLE pend option (option 0) is selected, any active MSRJE sessions 
continue processing until they are completed, but no new readers can be started. 
Any printers or punches needed to process data from the host system will be 
started, and the MSRJE console can be started. Once MSRJE has logged off from 
the host system, the DISABLE procedure is completed normally. 
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If the DISABLE retry option is selected (option 1), the DISABLE procedure is 
re-submitted. 

If the DISABLE immediate option (option 2) is selected, all MSRJE sessions active 
for the remote location are abnormally ended and termination of the link with the 
host system is attempted. 

If the DISABLE cancel option (option 3) is selected, the DISABLE procedure is 
not processed. 


MSRJE Unattended Mode of Operation 

MSRJE can run without an operator present. This is referred to as unattended 
operation. Transmitting data over a switched line after 5:00 p.m. is usually less 
expensive (based on line charges) because the discount rates are in effect. Using 
System/36 to collect data during the normal working hours and sending the data to 
the host system for processing after the end of the working day can be 
accomplished with System/36 MSRJE. 

Unattended mode of operation for MSRJE is handled in two areas: message 
handling and automatic termination. 

Message Handling for MSRJE Unattended Operation 

MSRJE uses the System/36 //NOHALT support to provide automatic responses 
to MSRJE-generated messages at all times. The NOHALT level of each user who 
signs on to MSRJE is used as the NOHALT level for user messages. In addition, if 
MSRJE attempts to display a message at a display station that has been released, 
the default responses are assumed regardless of the NOHALT level. 

Automatic Termination of MSRJE during Unattended Operation 

The value specified for the Termination delay in minutes prompt on display 34.0 
during the configuration process is used to set a time limit for termination of 
MSRJE. When all readers, printers, and punches have completed processing and 
the MSRJE console has been released, MSRJE waits the length of time specified by 
the Termination delay in minutes value. If the time period elapses, MSRJE begins 
normal termination. However, if a reader, printer, or punch is started or if the 
MSRJE console is started, the wait is canceled. If no delay value has been 
specified, MSRJE does not automatically terminate. 

The END utility control statement overrides the delay value specified on display 
34.0 during MSRJE configuration. 
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Getting the Status of MSRJE 


While MSRJE is running, you can get the current status by entering STATUS 
MSRJE or D M on the command line of a display station, or by selecting option 5 
from the Display Communications Status (COMMSTAT) menu. The following 
illustrates the status display presented: 



H MSRJE Console: Defines the display station that is currently signed on as the 

MSRJE console. 

Q Location: Identifies the remote location with which MSRJE is communicating. 

Q Host: Specifies the type of host subsystem with which MSRJE is 

communicating. 

Q Status: Indicates the current status of MSRJE for the location, as follows: 

• Active. MSRJE is currently communicating with the location. 

• Starting. An operator has signed on to MSRJE for the location, but 
MSRJE is not yet logged on to the host system. 

• Ending. MSRJE is ending communications with the remote location 
because an operator has entered an END utility control statement, 
canceled MSRJE, or requested an immediate disable, or because of a link 
error. 

• Inactive. The location is enabled, but no operator has signed on to 
MSRJE for the remote location. 
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MSRJE Readers: The number of configured MSRJE readers for this 
location. The number of readers corresponds to the Maximum number of 
MSRJE readers specified on display 37.0 during configuration of MSRJE for 
this remote location. 

Host Readers: Specifies the host readers that are currently active and 
communicating with MSRJE readers. 

WS-ID: Specifies the display station that is associated with the reader. A 
dash (--) indicates that the display station that started the reader has been 
released. If a work station or a dash is displayed but there is no 
corresponding Host RDRS entry, the MSRJE reader is waiting for a 
connection to a host reader. 

Printers: Printers specified for this MSRJE configuration. The number of 
printers corresponds to the Maximum number of printers specified on display 
36.0 for this remote location. 

Output: The destination of print data received for the associated printer, as 
follows: 

• ID. The ID of a System/36 printer. 

• CDISK. A compressed file (a disk file with 256-character unprocessed 
records). 

• **. For BSC MSRJE, specifies that processing for the printer is 
suspended. A CANCEL utility control statement may need to be entered 
to free the printer. 

Punches: Punches configured for this MSRJE location. The number of 
punches corresponds to the Maximum number of punches specified on display 
36.0 during configuration of this MSRJE location. 
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QQ Output: The destination of punch data received for the associated punch, as 
follows: 

• Disk. A disk file with a user-defined format. 

• CDISK. A compressed file (a disk file with 256-character unprocessed 
records). 

• **. For BSC MSRJE, specifies that processing for the punch is 
suspended. A CANCEL utility control statement may need to be entered 
to free the punch. 

Pressing command key 8 causes Help text for the status display to be presented. 
Pressing command key 15 causes the status display to be redisplayed with any new 
information. Pressing command key 16 causes the function to restart with a 
display of the first MSRJE remote location. Pressing the Roll Up key causes the 
next display for the current location, or the first display of the next enabled MSRJE 
location, if any, to be displayed. 

The status is a split display. The top part of the display (above the dashed line) is 
the status information. The bottom part of the display allows you to select a menu 
option (2) to start or stop a communications line, or to enter a command on the 
command line. 
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Chapter 4. Controlling an MSRJE Session 


Utility control statements can be used to control an MSRJE session once it has 
been started. The utility control statements can be used to control the input, 
output, and termination phases of MSRJE operation. The utility control statements 
and the phases they affect are shown in the following table: 


Phase 

Statement 

Input 

READFILE 

LIBRARY 

EOF 

CANCEL 

Output 

CANCEL 

SETFORM 

INFOMSG 

Termination 

END 


Each utility control statement can also be classified as to whether it serves as 
reader input or console input and as to the devices from which it may be entered. 


Input Type 

Entered From 

Statement 

Reader input 

Display station or disk 

READFILE 

LIBRARY 

EOF 

SETFORM 

INFOMSG 

END 

Console input 

Console keyboard 

READFILE 

LIBRARY 

CANCEL 

SETFORM 

INFOMSG 

END 


Note: You can cancel MSRJE by using options 2 and 3 on the inquiry display. 
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MSRJE Utility Control Statements 


Each MSRJE utility control statement consists of a statement identifier and, for 
most utility control statements, parameters. The statement identifier is always the 
first word of the statement. The parameters supply the necessary information to 
the utility. Each parameter consists of a parameter keyword, which identifies the 
parameter, and the value to be supplied to MSRJE or, for the CANCEL utility 
control statement, just the value. 

The general format of an MSRJE utility control statement is: 

.. statement-identifier keyword-value,...keyword-value comment 
(. . s ) ' --———-- ~ 

Rules for Coding MSRJE Utility Control Statements 

The rules for coding MSRJE utility control statements are: 

statement-identifier: Two periods (.. ) followed by one blank must be placed 
before the statement-identifier. Blanks are not allowed within the 
statement-identifier. Certain statements can use a single letter abbreviation in 
place of the full statement-identifier. In the sections that follow, the 
abbreviation is indicated by the letter within parentheses beneath the full 
statement-identifier. 

keyword-value: Parameters can be entered in any order. A comma is required to 
separate one parameter from another (do not place any blanks between 
parameters). A parameter is identified by a keyword, which is followed by a 
hyphen (-) and the value assigned to the keyword (the CANCEL utility 
control statement does not use this format). 

comment: Comments can be included in utility control statements when parameters 
are entered. Leave one or more blanks after the last keyword-value and the 
comment. 

If you want an entire statement to be a comment, begin the statement with 
two periods, a blank, and an asterisk (.. *). 


4-2 Multiple Session Remote Job Entry Guide 



READFILE Utility Control Statement 


The READFILE statement tells MSRJE to begin reading data from a disk file, 
procedure member, or source member. A READFILE statement can be entered 
from either the reader input display or the console input displa y, or it can be read " 
from a file or member on disk. — 


The format of the READFILE statement is: 


READFILE NAME-name [,LIBR-name] 

[,DATE-date] 

, TYPE-f p") 

R) 


s 



u\ 


’ 


■ 

CMD- lYl 


, DEL- fyl 

w 


In] 



_ 
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NAME: Specifies the name of the disk file or the name of the source or procedure^— 
member that is to be read by the reader. 

Note: MSRJE cannot read folders or remote files. 

LIBR: For source or procedure members only, specifies the name of the library in 
which the member can be found. If a library name is specified, only that 
library is searched for the member. If a member is specified for the NAME 
parameter and no entry is made for the LIBR parameter, MSRJE searches the 
current library for the member. If the member is not found in that library, 
the system library (#LIBRARY) is searched. If LIBR-0 is specified, only the 
system library (#LIBRARY) is searched. 

If the member cannot be found, a message is displayed requesting that the 
LIBR or NAME value be corrected. 

If TYPE-D is specified or if no type is specified and D is specified for the 
Specify default value for TYPE prompt on display 37.0 during subsystem 
member configuration, specifying a value for LIBR causes a message to be 
displayed. 

DATE: Specifies the file creation date of the disk file to be read by MSRJE. If a 
date is not specified for a disk file, the named file having the latest creation 
date is read. The format of the date must be the same as the system date 
format. 

If TYPE-S or TYPE-P is specified or if no type is specified and the Specify 
default value for TYPE prompt on display 37.0 was specified as P or S during 
subsystem member configuration, the DATE parameter is invalid, and its use 
causes a message to be displayed. 

TYPE: Specifies the type of file or member specified by the NAME parameter. 
TYPE-S indicates a source member; TYPE-P indicates a procedure member; 
and TYPE-D indicates a disk file. If no entry is made for the TYPE 
parameter, the default specified on display 37.0 during MSRJE configuration 
is used. 
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CMD: Specifies whether MSRJE is to process any utility control statements that 
are in the file or member. 

CMD-Y indicates that the file or member may contain MSRJE utility control 
statements and that MSRJE is to process any utility control statements found. 
All other records are transmitted to the host system as data. All records 
within the file or member must be 80 characters in length. 

When CMD-Y is specified for a file or member, MSRJE attempts to process 
any record that begins with .. (period period blank) as a utility control 
statement. If the record is not a utility control statement, the results will be 
unpredictable. 

CMD-N specifies that the file or member contains data only. If CMD-N is 
specified for a file or member containing utility control statements, the utility 
control statements are sent to the host system as data. 

The default value for the CMD parameter is the specification made for the 
Specify default value for CMD prompt on display 37.0 during MSRJE 
configuration. 

If CMD-Y is specified on a READFILE statement and Y was specified for 
the Transparency? prompt on display 37.0 during MSRJE configuration, 
unpredictable results may occur. If transparency is specified and the file is 
designated as CMD-Y, it is possible that the first three characters of a data 
record could be two periods followed by a blank (..). If this happens, 

MSRJE will attempt to process the record as a utility control statement. You 
should be certain that no files specified as containing utility control 
statements and using transparency contain records that start with 
period-period-blank unless those records are MSRJE utility control 
statements. 

DEL: Specifies whether deleted records in a file are to be sent to the host system. 
This parameter applies only when TYPE-D is specified and the disk file is a 
delete-capable sequential or direct file. 

DEL-Y specifies that all records within the file, including records marked as 
deleted, are to be sent to the host system. 

DEL^^Pspecifies that deleted records are not to be sent to the host system. 

The default is the value specified for the Specify default value for DEL prompt 
on display 37.0 during MSRJE configuration. 
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READFILE statements can be nested; that is, a file or member can contain a 
READFILE statement that tells the reader to read another file or member. For 
example, file A contains a READFILE statement that references file B. When the 
statement is processed by MSRJE, reading of file A is suspended and the reader 
begins processing file B. Once the reader has completed processing file B, it 
returns to processing file A at the record immediately following the one that caused 
it to process file B. The following illustrates how nesting works with two files. 



FILE A FILEB 

S790901 8-0 


To further illustrate nesting, assume you have three files: file A, file B, and file C. 
File A contains a READFILE statement that directs the reader to begin processing 
file B. File B contains a READFILE statement that directs the reader to begin 
processing file C. 

When the READFILE statement in file A is processed, the reader begins reading 
file B. When the READFILE statement in file B is processed, the reader begins 
reading file C. Once file C has been read, the reader returns to the record 
immediately following the READFILE statement in file B. Once file B has been 
processed, the reader returns to the record immediately following the READFILE 
statement in file A. The following illustrates this type of nesting. 



FILE A FILEB FILE C 

S790901 9-0 

The number of READFILE statements that can be nested varies depending on the 
System/36 resources (such as disk space and storage) available when MSRJE is 
running. Generally, at least 16 levels of nesting are possible. 
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LIBRARY Utility Control Statement 


When a source or procedure member is specified in a READFILE statement and 
no LIBR value is specified, MSRJE searches the current library for the member. If 
the member is not found, the system library (#LIBRARY) is then searched. If a 
library is specified for the LIBR parameter on the MSRJE procedure command, 
only that library is searched for the named member. 

The LIBRARY statement allows you to specify a new current library. This library 
is used as the current library until another LIBRARY statement is processed, 
reading of the file or member is completed, or until the reader terminates. If the 
file or member is completed, the library that was active before MSRJE began 
reading that file or member becomes the current library again. If the reader 
terminates, the library that was active before the reader started is restored. 

The format of the LIBRARY statement is: 

.. LIBRARY NAMEMname) 

(.. L) (0) 

name: Specifies the name of the library that is to be searched first when a member 
is specified for a subsequent READFILE statement. 

0 : Specifies that the system library (#LIBRARY) is to be used. 

The following example illustrates the use of the LIBRARY utility control statement 
and shows how library usage is changed and restored. Assume that an MSRJE 
session has been started and that the current active user library is named LIBA. 


.. READFILE NAME-PROCA1,TYPE-P,CMD-Y 


LIBA 


PROCA1 

Q .. LIBRARY NAME-LIBB 

H .. READFILE NAME-PROCB1,TYPE—P,CMD-Y 



LIBB 

LIBC 

PROCB1 

_PROCC 

.. R NAME-PROCB2,TYPE-P 

/ 

.. LIBRARY NAME-LIBC Q / 


.. R NAME-PROC,TYPE-P j| / 

□ 


. . EOF |Q 


PROCB2 


S7909020-0 
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A READFILE statement that specifies a procedure member (TYPE-P) 
named PROCA1 is processed, and no LIBR parameter value is specified. 
Therefore, LIBA is searched for PROCA1. If it is not found in LIBA, the 
system library (#LIBRARY) is searched. 

A LIBRARY statement that specifies LIBB is processed; this causes LIBB to 
become the current active user library. 

A READFILE statement that specifies a procedure member (TYPE-P) 
named PROCB1 is processed. LIBB is searched for PROCB1. 

A READFILE statement is processed in PROCB1, which specifies PROCB2, 
a procedure member. No LIBR parameter is specified; therefore LIBB is 
searched. 

PROCB2 completes processing, and the reader resumes processing PROCB1 
(at the statement immediately after the READFILE). 

A LIBRARY statement is processed in PROCB1 that specifies LIBC. 
Therefore, LIBC becomes the current active user library. 

READFILE statement in PROCB1 is processed with a member (PROCC) 
specified (TYPE-P), but with no LIBR parameter specified. Therefore, LIBC 
is searched for the member. If PROCC is not found in LIBC, #LIBRARY is 
searched. 

Processing of PROCC completes and returns to PROCB1 at the statement 
immediately after the READFILE that specified PROCC. 

Processing of PROCB1 continues. 

An EOF statement is then processed by MSRJE. The reader terminates, and 
the user library active when the reader started is restored (LIBA). 
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EOF Utility Control Statement 



The EOF (end-of-file) utility control statement ends reader input to the host 
system and terminates the MSRJE reader. 

The EOF statement is only valid as reader input. 

The format of the EOF statement is: 

. . EOF 
( . . E) 

The EOF statement has no parameters. 

When an EOF statement is read, MSRJE sends all data read before the EOF 
statement to the host system and ends the reader. 

No more data is requested from either the member or file being read from disk or 
from the operator at the keyboard. If MSRJE is reading a member or file and does 
not find an EOF utility control statement before the end of the member or file, 
MSRJE requests input from the device from which the last READFILE utility 
control statement was read, beginning at the record immediately following the 
READFILE utility control statement. If the last READFILE was read from a 
display station that has since been released, MSRJE will simulate an EOF utility 
control statement. 
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CANCEL Utility Control Statement 


The CANCEL utility control statement can be entered only as console input. It 
allows you to cancel one of the MSRJE utility functions. The format of the 
CANCEL statement is: 


.. CANCEL LRDn 
RDn 
PRn 
PUn 

(.. C) J 

S7909021-0 

LRDn: Causes MSRJE reader n to be cancelled. The value for n can be from 1 
through 32. 

RDn: Terminates the MSRJE reader associated with host reader n. The value for n 
can be from 1 through 15. 

PRn: Terminates the MSRJE printer associated with host printer n. The value for n 
can be from 1 through 15. 

PUn: Terminates the MSRJE punch associated with host punch n. The value for 
n can be from 1 through 15. 


To determine the number to use, you must first view the status of MSRJE using the 
STATUS MSRJE procedure command. 

When the CANCEL utility control statement is used to cancel a reader, it ends the 
reader before the EOF utility control statement or the end of data is processed. 
However, to the host system, it appears that the reader terminated normally. 

When the CANCEL utility control statement is used to cancel a printer or a punch, 
it causes the printer or punch to: 


1. Stop processing the data set it is currently receiving and discard any of the data 
set not yet processed 

2. Prepare to process the next printer or punch data stream 
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When a permanent error occurs on the device to which BSC MSRJE is writing 
print or punch data, the CANCEL statement may have to be used to recover data. 
For example, MSRJE printer PR1 is processing output for job A. The host system 
is sending print data to System/36 for job A; some of the data has been received 
by System/36, and some has not yet been sent by the host system. While 
processing the print data, a permanent error occurs on the device to which MSRJE 
is writing the data. The MSRJE printer must terminate; however there is no way to 
inform the host system that no more output for job A can be accepted and that all 
the output should be saved at the host for later transmission. System/36 suspends 
all output for that device; that is no output for job A or any subsequent job can be 
received by PR1 until the operator intervenes. To end the suspension, you can do 
one of the following: 

• Save the output for job A, by entering the host system commands (as console 
input) to stop the host system printer and to place the job output on the job 
queue again; or if you do not want to save the output, enter the host system 
command to cancel the host system printer. 

• Enter the MSRJE CANCEL utility control statement to cancel the MSRJE 
printer that failed. MSRJE then receives and discards all subsequent output for 
job A. Any subsequent output for that host system device is processed 
normally by MSRJE. 

The CANCEL utility control statement is not always needed. For example, assume 
that MSRJE printer PR1 is receiving output for job B. The output data set has 
been received by MSRJE. However, not all of the received data has been 
processed by the MSRJE printer. A permanent error occurs on the device to which 
MSRJE is writing the data. Because MSRJE has received the entire output data 
set, it cannot suspend the output from the host system. MSRJE discards all 
received data and automatically prepares to handle the next output data set. 
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SETFORM Utility Control Statement 

The SETFORM utility control statement allows you to change the forms name for 
any configured MSRJE printer or punch. If you configured any forms set other 
than 0 (on display 34.0 during subsystem configuration) and MSRJE terminates 
without receiving a new forms name for the specified device, then the forms name 
you supply with the SETFORM utility control statement is saved in the form set 
member. 

The format of the statement is: 

. . SETFORM f PRnl -forms name[ , f PRn) -forms name] [ , . . .] 

1 PUnJ \PUnJ 

(.. S) 

S7909022-0 

PRn, PUn: Specifies the host system device ID. The value specified for n can be 
from 1 through 15. PRn designates a printer; PUn designates a punch. 

forms name: Specifies the forms name to be used for the specified device. The 
entry can be from 1 to 8 characters and can consist of any characters except 
comma (,), slash (/), apostrophe (’), question mark (?), or hyphen (-). 

A forms name of all blanks can be specified by placing a comma immediately 
after the hyphen (-) following a PRn or PUn keyword, or by following the 
hyphen with a blank if the forms name is the last parameter (anything after 
the blank is ignored). For example, to specify a forms name of all blanks for 
printer PR1, either of the following could be used: 

.. SETFORM PR1-,PR2-ABC 
or 

.. SETFORM PR2-ABC,PR1- 

---- 

Each SETFORM statement can specify multiple printers and/or punches; the 
maximum statement length is 120 characters for console input and 80 characters 
for reader input. 
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I INFOMSG Utility Control Statement 


The INFOMSG utility control statement indicates to MSRJE whether 
informational messages are to be displayed at the MSRJE console. 

The format of the INFOMSG utility control statement is: 

. . INFOMSG f YES') 

l N0 J 

(.. I) 

S7909023-0 


YES: Specifies that informational messages are displayed at the console unless 
otherwise specified on display 34.0 during subsystem member configuration 
or by an INFOMSG utility control statement. 

NO: Specifies that most MSRJE-generated informational messages are sent only 
to the history file. This allows console messages from the host to be 
distinguished more easily and allows them to remain on the MSRJE console 
screen longer. 
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END Utility Control Statement 


The END utility control statement indicates that MSRJE should send the 
appropriate sign-off message to the host system as soon as all readers, 
printers, and punches have completed processing. No new readers can be 
started after this statement has been entered. 


The format of the END utility control statement is: 

.. END [DELAY-nn] 

The END statement cannot be abbreviated. 

DELAY: Specifies the amount of time, in minutes, that MSRJE is to wait after all 
readers, printers, and punches have terminated before sending the sign-off to 
the host system. The value specified can be from 0 to 99. If no value is 
specified, 0 is assumed. The value specified here overrides the value, if any, 
specified for prompt 2 (Termination delay in minutes) on display 34.0 during 
subsystem configuration. 

DELAY-0 specifies that MSRJE will send the sign-off command to the host 
system as soon as all readers, printers, and punches have completed 
processing. If any other value is set for the DELAY parameter, MSRJE waits 
that number of minutes after all readers, printers, and punches have 
completed before sending a host system sign-off. No new readers can then 
be started, but if printer or punch data is received from the host system 
before the time elapses, the appropriate MSRJE printer or punch is started. 
When those printers or punches complete processing, MSRJE will again wait 
the specified time before sending a host system sign-off. 

Note: Use caution when entering the END utility control statement as reader input. 
No other users will be able to start MSRJE readers after the END utility 
control statement has been processed. 
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Chapter 5. Creating and Maintaining Forms Control Tables 



You use the MSRJE control table utility (RJTABLE) to build a table that contains 
entries to define how output data streams received from the host system are to be 
handled by MSRJE. You also use RJTABLE to define how the MSRJE file utility 
(RJFILE) is to handle 256-character unprocessed record files created by MSRJE. 

Using the control table utility, you can define entries in a table to specify whether 
print data streams are to be written to a printer or to a file containing 
256-character unprocessed records; you can also define whether punch data 
streams are to be written to a file you define or to a file containing 256-character 
unprocessed records. 

You assign a name to each entry (except the print and punch default entries) in the 
table. When a forms name is received from the host system in a data stream, the 
control table specified on display 36.0 during subsystem configuration is searched 
for a matching entry name. If a matching entry name is found in the table, the 
definitions in that entry are used to control the handling of the output. 


You can also use the utility to define a print default entry and a punch default entry 
for each control table you create. The default entries are used whenever a forms 
name is received from the host system and there is no matching entry in the table. 
Whenever you create a forms control table, these defaults are automatically 
included; to change their definition, you must update the default entries. 

| \ Note: For those hosts which do not send forms mount messages or peripheral data set 

| 1 information records, there is no access into the forms control table except to 

| V the default entries. 


To ensure that MSRJE can read the file that contains the control table, you should 
authorize user ID MSRJE to have at least read access to the file that contains the 
control table. Refer to the System Security Guide for additional information on 
resource security. 
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Control Table Entries for Print Data Streams 

Print data received from the host system can be written to a printer using the 
characteristics you define; or the data can be written to a sequential file containing 
256-character unprocessed records. (Unprocessed records are contained in a 
compressed disk file.) 

When print data is received from the host system and the host system sends a 
forms name with the data, MSRJE searches the control table (as specified on 
display 36.0 during subsystem member configuration) for an entry with the same 
name as the received host forms name. If a matching entry is found, the definition 
for that entry is used to control the output. If no match is found, the printer 
default entry in that control table is used to control the output. If you have not 
specified a forms control table or if the table you specified cannot be read, MSRJE 
uses the IBM-supplied values to control the output. 

If print data is written to a compressed disk file, you must also define the 
characteristics needed to print the disk file. You must use the RJFILE procedure 
command, as described in Chapter 6, to print a 256-character compressed disk file. 
The printer characteristics definition in the same control table entry as that used to 
create the compressed disk file is used to control the printing of the file. 

If you are defining an entry for print data that is to be written to a printer, you 
specify: 

• What the local (System/36) form name is to be 

• The printer to which the data is to be written 

• Whether the operator is to be given a chance to align the form (paper) in the 
printer 

• Whether the received data is to be spooled 

| • Final quality printing or draft quality printing 

| • Whether to issue an end of forms message 

| • Whether to select a printwheel ID for the printer 

| • Style-of-print option selected 

• The number of lines per inch to print 

• The number of characters per inch to print 

• The number of lines to print on a page 

• The number of the last line to be printed on a page 

• Carriage control information 
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If the data is to be spooled, you also specify: 

• Whether to retain the data in the spool file after it has been printed 

• Whether printing is to begin only after the job step ends 

• Whether all output to the printer is to be treated as a single print step (only 
used with the RJFILE utility as defined in Chapter 6) 

• The number of copies to be printed 

• The spool file priority of the job 

• How much activity you expect this spool file to have 

If you are defining an entry to write received print data to a file as 256-character 
unprocessed records, you define the characteristics of the file, such as: 

• The name of the file 

• The user ID when resource security is active on System/36 

• The expected size of the file 

• Whether the file can be extended beyond its expected size, and if it can, the 
extension size to use 

• Where you would prefer the file be located 

• Whether the file is to be saved if an error occurs 

• Whether you want the data received for this entry added to an existing file 

• Whether allocated disk space not needed by the file can be released for use by 
other files 

If you specify that the output is to go to a compressed disk file (a file with 
unprocessed records), you also specify the same information as you specify when 
the data goes to a printer. The printer information included with the compressed 
disk entry is used to control the printing of the file by the RJFILE utility, as 
described in Chapter 6. 
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Control Table Entries for Punch Hutput 

Punch data received from the host system can be written to a disk file (the 
characteristics of which you define), or the data can be written to a file containing 
256-character unprocessed records (compressed disk file). 

When punch data is received from the host system and the host system sends a 
forms name with the data, MSRJE searches the control table (as specified on 
display 36.0 during subsystem member configuration) for an entry with the same 
name as the received host forms name. If a matching entry is found, the definition 
for that entry is used to control the output. If no match is found, the punch default 
entry in that control table is used to control the output. If you have not specified a 
forms control table or if the table you specified cannot be read, MSRJE uses the 
IBM-supplied values to control the output. 

If the punch output is written to a file you define, that file can be processed later by 
one of your programs. If the data is written to a compressed disk file (a file with 
unprocessed records), you must also define, within the same control table entry, 
another file. You then use the RJFILE procedure command, as described in 
Chapter 6, to convert the compressed disk file to the file you defined. RJFILE 
uses the same entry in the same control table as was used to create the compressed 
disk file. 

If the punch output is to be written to a user-defined file, you define: 

• The name of the file. 

• The user ID when resource security is active on System/36. 

• The name of a System/36 procedure, if any, that MSRJE should start after the 
punch data stream has been completely received. MSRJE passes two 
parameters, the file date (parameter 1) and the file name (parameter 2), to the 
System/36 procedure. 

Note: The values in these parameters are ignored if RJFILE is using this entry. 

• The name of the library in which the procedure is located. 

• The type of file (sequential, direct, or indexed) to create. 

• Whether the file is to be saved if an error occurs. 

• Whether you want the data received for this entry added to an existing file. 

• Whether allocated disk space not needed by the file can be released for use by 
other files. 

• The expected size of the file. 
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• Whether the file can be extended beyond its expected size and, if it can, the 
extension size to use. 

• Where you want the file located. 

• The record length for the file. 

• Whether the file is delete-capable. 

If you specified that the file is to be an indexed file, you also specify: 

• The starting position of the index key 

• The length of the key 

• Whether duplicate keys are allowed in the file 

When you want the punch data stream written to a compressed disk file (a file with 
unprocessed records), you specify: 

• The name of the file 

• The user ID when resource security is active on System/36 

• The expected size of the file 

• Whether the file can be extended beyond its expected size and, if it can, the 
extension size to use 

• Whether the file is to be saved if an error occurs 

• Where you would prefer the file be located 

• Whether you want the data received for this entry added to an existing file 

• Whether allocated disk space not needed by the file can be released for use by 
other files 

You must also specify the same information as you specify when the data goes to a 
user-defined file. The user file information included with the compressed disk 
entry is used to control the converting of the compressed file by the RJFILE utility, 
as described in Chapter 6. 

Note: MSRJE does not support creating folders or remote files . 
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Running the Control Table Utility 


Control Table Menu 


The control table utility is an interactive utility; that is when it is activated, it 
presents a series of displays to request that you enter the needed information to 
define an entry in the control table. 

To start the control table utility, enter RJTABLE (the RJTABLE procedure 
command has no parameters) on the command line, or select option 5 (Define an 
MSRJE control table) from the Define Communications display. The first display 
presented is the Control Table menu. 



MSRJE CONTROL TABLE UTILITY 
Work with control tables 


'N 


Select one of the following: 

1. Create a new table 

2. Update entries in an existing table 

3. Add entries to an existing table 

4. Remove entries from an existing table 

5. Remove a table 

6. Print entries from an existing table 

7. Print a table 

8. Review entries in an existing table 

9. End the control table utility 

Option . 2 

Table name . 


Cmd7-End of job 
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Select one of the following: 

1. Create a new table 

2. Update entries in an existing table 

3. Add entries to an existing table 

4. Remove entries from an existing table 

5. Remove a table 

6. Print entries from an existing table 

7. Print a table 

8. Review entries in an existing table 

9. End the control table utility 
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Table name: You must specify the name of the forms control table with which you 
want to work. If you are creating a new table (option 1), enter the name you 
want assigned to the table and the file in which the table is stored. If you 
intend to work with entries in an existing table (option 2, 3, 4, 6, or 8), enter 
the name of the existing table. The next display, the Control Table Utility 
Entry menu, is presented. If you select option 5 (Remove a table), the entire 
table and the file in which it is stored are deleted. The Control Table menu is 
presented again. If you select option 7 (Print a table), enter the table name. 

If you select option 9, the control table utility ends and the System/3 6 
command display is presented. 

When the Control Table menu is present, pressing command key 7 cancels the 
control table utility. 

If you select option 1, specify a table name, and press the Enter key, the MSRJE 
Control Table menu is presented again. You have the option to specify a preferred 
disk location, as shown on the following display: 



MSRJE CONTROL TABLE UTILITY 
Work with control tables 


"\ 


Optional-* 


Select one of the following: 

1. Create a new table 

2. Update entries in an existing table 

3. Add entries to an existing table 

4. Remove entries from an existing table 

5. Remove a table 

6. Print entries from an existing table 

7. Print a table 

8. Review entries from an existing table 

9. End the control table utility 

Option . 1 

Table name.FORMFILE 

Preferred disk location . A1,A2,A3,A4,block number A1 * 

Cmd7-End of job Cmd2-Page back 
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Chapter 5. Creating and Maintaining Forms Control Tables 5-7 






Preferred disk location: This prompt appears only if you select option 1 (Create a 
new table). Specify either the disk on which you want the table placed, the 
block number at which the table should begin, or blanks. The table is placed 
on the: 

• First disk if you specify Al, the default 

• Second disk if you specify A2 

• Third disk if you specify A3 

• Fourth disk if you specify A4 

Al, A2, A3, and A4 are only preferred locations. If the disk you specify is 
full or does not exist, the table is placed wherever there is room. 

A block number can be any 6-digit number less than 312815. Your table is 
placed at the block location you specify only if that location is available. If it 
is not available, you receive a message stating it is not available and you can 
specify another block location or disk. 

If you specify blanks, the table is placed on the least used disk. This helps 
maintain an even balance between disks. 

After you enter a preferred disk location, the next display, the Control Table 
Utility Entry menu, is presented. 
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Control Table Utility Entry Menu 


The Control Table Utility Entry menu allows you to select what you want to do 
with an entry in a control table. 

The heading of this display identifies what you are going to do with the table. The 
example shows Create a control table entry because option 1 was selected on the 
first display. If option 2 had been selected, the heading would be Update a control 
table entry ; for option 3, it would be Add a control table entry . In all cases, the name 
of the table entered for the Table name prompt on the previous display is shown in 
the upper right corner. 

If you selected option 1 (Create), 2 (Update), or 3 (Add) on the Work with controL 
tables display, you will see the following display. 


MSRJE CONTROL TABLE UTILITY 


Create a control table entry 


Select a type of entry to work with: 

1. Print 

2. Print default 

3. Punch 

4. Punch default 

Option . 


FORMFILE 


1 


Select where the output is to go: 

1. Printer 

2. Disk file 

3. Compressed disk file 

Option . 1 


Table entry name 


L Cmd3-Save table, display table menu Cmd7-Save table, end of job 

(c) 1983 IBM Corp. 
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If you selected option 4 (Remove entries), 6 (Print entries), or 8 (Review entries) 
on the Work with control tables display, you will see the following display. 



I 


I 


If you selected option 5 (Remove a table) or 7 (Print a table) on the Work with 
control tables display that display is shown again. 

Following are the options which you need to enter on the Create a control table 
entry display, depending on the option that you choose on the Work with control 
tables display. 


Select a type of entry to work with: Specify the type of control table entry with 

which you are working. The valid options are: 

1. Print specifies that the entry is for print data received from the host system. 

2. Print default specifies that the entry is to be used when no matching entry 
name is found for the forms name received for print data from the host system. 

3. Punch specifies that the entry is for punch data received from the host system. 

4. Punch default specifies that the entry is to be used when no matching entry 
name is found for a punch data stream forms name received from the host 
system. 



Select where the output is to go: Specify where the output associated with this 
entry is to be written. 

1. Printer specifies that print data received is to be written to the printer. Valid 
only if the entry type is print or print default. 


2. Disk file specifies that punch data received is to be written to a disk file. Valid 
only if the entry type is punch or punch default. 
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3. Compressed disk file specifies that the data (print or punch) that is received is 
to be written to a sequential disk file as 256-character unprocessed records. 
Valid for all entry types. 


Table entry name: Specify the name of the control table with which you are 

working (creating, updating, adding, or removing). When a forms name is 
received from the host system, it is compared to this name. If they match, 
this entry is used to control the output of that data stream. 


Notes: 




\ 


1. If you selected option 3 (Add entries to an existing file) on the Control Table 
menu and if an entry matching the Table entry name you enter already exists in 
the table, a message is presented giving you two options: 

a. Change the Table entry name you entered. 

b. Press the Enter key , which causes the utility to change from the add mode to 
the update mode. You can then change the existing entry in the control table. 

2. If you selected option 2 (Update entries in an existing table) on the Control Table 
menu and if the name you specify for the Table entry name prompt does not 
match a control table entry , a message is displayed and you are given two options: 

a. Change the Table entry name you entered. 

b. Press the Enter key ; which causes the utility to change from the update mode 
to the add mode. You can then add the new entry to the control table. 

If you selected option 4 (Remove an entry) on the Control Table menu, the entry 
menu is redisplayed after you have typed the Table entry name and pressed the 
Enter key. You can then remove another entry, or return to the Control Table 
menu display by pressing command key 3. 

Pressing command key 3 while the entry menu is present saves all valid entries and 
causes the Control Table menu to be displayed; pressing command key 7 saves the 
forms control table file and ends the utility. 

The remainder of this chapter is organized by the functions you can perform using 
the control table utility. The displays presented are dependent on the option you 
can choose on the entry menu; therefore, the chapter is organized to lead you 
through each option. The options are: 

• Create, update, review, or add a print entry for printer output 

• Create, update, review, or add a print entry for compressed disk output 

• Update or review a print default entry for print output 

• Update or review print default entry for compressed disk output 

• Create, update, review, or add a punch entry for disk output 

• Create, update, review, or add a punch entry for compressed disk output 
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• Update or review a punch default entry for disk output 

• Update or review a punch default entry for compressed disk output 

The name of the file, as specified on the Control Table menu, and the name of the 
control table entry, as specified on the entry menu, are displayed in the upper right 
corner of all the following control table utility displays. 

Note: A control table entry name is not displayed if you are working with default 
entries or if you specified blank characters for the entry name. 

Whenever any of the following displays is present, pressing command key 3 saves 
all valid entries and returns you to the entry menu; pressing command key 7 
cancels the current entry, saves the file, and ends the utility. 

Print Entry for Printer Output 

To create a print entry with output directed to the printer, select option 1 (Create a 
new table) or option 3 (Add entries to an existing table) on the Control Table 
menu, and then select option 1 (Print) and option 1 (Printer) on the entry menu. If 
you are updating an existing entry (option 2 on the Control Table menu), the 
current values are presented for the named entry on each of the displays. You can 
change any of those values. After you have entered the Table entry name on the 
entry menu (the table entry name defines the entry in the table), the next display is 
presented. 


MSRJE CONTROL TABLE UTILITY 
Create an MSRJE forms control table print entry 


Local forms name . 

Printer ID or SYSTEM . 

Align the forms before printing? . N,Y 

Spool?.Y,N 

Final quality printing? . N,Y 

Issue end of forms message?.Y,N 


Select a printwheel ID for the printer?.N, Y 


FORMFILE 
RESFORM1 




Optional-* 


* 


SYSTEM 

N 

Y 
N 

Y 
N 


I 


Cmd3-Save entry, display entry menu 



Cmd7-End of job, cancel entry 

(c) 1985 IBM Corp. 


Local forms name: Specify the forms name for the System/36 to which the 
received host forms name is to be translated. If no entry is made, no 
translation is done. 

Printer ID or SYSTEM: Specify the work station ID of the printer that is to print 
this output. If you intend to use the system printer, then specify SYSTEM. 
SYSTEM is the default. 
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Align the forms before printing?: Specify whether you want the operator to have an 
opportunity to align the forms on the printer before the data begins printing. 
If you specify Y (Yes), the first line of output is printed, and a message is 
issued. The operator can then align the form and select an option that .causes 
the first line to print again and the same message to be displayed, or the 
operator can select an option that allows printing to continue with the second 
line of output. 

If N (No), the default, is specified, the output is printed, without allowing the 
operator to align the forms. 

Spool?: Specify whether you want output controlled by this entry to be spooled. If 
you specify N (No), printer output controlled by this entry is not spooled, but 
is printed as it is received. If you specify Y (Yes), then the output can be 
written to the System/36 spooled file instead of directly to the printer. If 
spooling is not active on System/36, this option is ignored. 

Final quality printing?: Specify the print quality you want. If final quality printing N 
(No) is specified, and the print quality switch on the printer is set to draft 
quality, the output will be printed in draft quality. Any other combination 
causes the output to be printed in final quality. 

Issue end of forms message?: Specify Y (Yes) if you want an end of forms message 
to be sent to the console. 

Select a printwheel ID for the printer?: Specify Y (Yes) if you want to select a 
printwheel ID for the 5219 Printer. If you specify Y, the display that allows 
you to specify the option for the style of print that is to be put on the 5219 
Printer is shown. 


MSRJE CONTROL TABLE UTILITY 


Create an MSRJE forms control table print entry 


FORMFILE 
RESFORM1 


"\ 


Optional-* 


Select the option for the desired style of print 


Style of print 

ID values 

Style of print 

ID values 

1 . 

Rhetoric 

05 

11 . 

Light Italic 

5B 

2. 

Courier 10 

OB 

12. 

Modern 

9E 

3. 

Prestige Pica 

OC 

13. 

Boldface 

9F 

4. 

Artisian 10 

0D 

14. 

Essay 

A0 

5. 

Pica 

14 

15. 

Essay Italic 

A2 

6. 

Symbol Scribe 

50 

16. 

Prestige 15 

DD 

7. 

Script 

54 

17. 

Gothic 15 

DE 

8. 

Courier 12 

55 

18. 

Courier 15 

DF 

9. 

Prestige Elite 

56 

19. 

Symbol Diplomat 

Scribe El 

10. 

Option 

Letter Gothic 

57 



1-19 


Cmd3-Save entry, display entry menu Cmd7-End of job, cancel entry 
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Select the option for the desired style of print: If you entered Y to select a 

printwheel ID for the printer, you see a display on which you can select the 
desired style of print on the 5219 printer. The default is specified through the 
CNFIGSSP procedure. The printwheel ID cannot be specified when 
characters per inch is specified on the following display. 

The next display allows you to specify the format of the printed output, such as the 
number of lines per inch and lines per page to be printed. You also define how 
carriage control characters received from the host system in a print data stream are 
to be handled by the printer. 


r 


MSRJE CONTROL TABLE UTILITY 
Create an MSRJE forms control table print entry 


FORMFILE 
RESFORM1 




Optional-* 


Lines per inch 





. 4,6,8 


* 

Characters per 

inch .... 


. 


. 10,15 


* 

Lines per page 



. . . . , 


. 1-112 


* 

Line number of 

the last line 

per page 

. . . . , 


. 1-112 


* 

Line skips for 

forms: 







01 - 1 

02 - 

0 

03 - 

0 

04 - 

0 


05 - 0 

06 - 

0 

07 - 

0 

08 - 

0 


09 - 0 

10 - 

0 

11 - 

0 

12 - 

0 


Cmd3-Save entry, display entry menu 

Cmd7-End 

of job. 

cancel 

entry 
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Lines per inch: This prompt is valid only for the following printers: 

• 5224 Models 1 and 2 

• 5225 Models 1, 2, 3, and 4 

Valid entries are 4, 6, or 8 lines per inch. If no entry is made, the current 
\ specification for the printer is used. 

'x ( 

Characters per inch: Specify whether you want the data printed at 10 or 15 
characters per inch. This prompt is valid only for the following printers: 

• 5224 Models 1 and 2 

• 5225 Models 1, 2, 3, and 4 

If the entry is left blank, the current specification for the printer is used. 

I 
I 

Lines per page: Specify the number of lines on each page (the form size). Valid 
entries are any decimal number from 1 to 112. If you do not enter a value, 
the current specification for the printer is used. 


Note: You cannot use this prompt if you specified a printwheel ID on the 
previous display. 
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Line number of the last line per page: Specify the number of the last line to be 
printed on a page. Valid entries are any decimal number from 1 to 112, but 
the value must be equal to or greater than the specification made for the 01 
line skip, and it must be less than or equal to the value specified for Lines per 
page. 

The default is the value specified for the Lines per page prompt or, if no value 
was specified for that prompt, the current lines per page specification for the 
printer. 

Note: If you did not specify a value for the Lines per page prompt, then you 
must not enter a value here. 

Line skips for forms: Specify which line on a page you want the printer to advance 
(skip) to when the corresponding channel control character is received. Up to 
12 entries (channel control characters 01 through 12) can be made. Each 
entry identifies a line number, and it must be less than or equal to the value 
specified for the Line number of the last line per page prompt. 

A channel control character whose assigned value is 0 causes the printer to 
advance one line. 



The default value for channel control character 01 is 1; the default for all 
other channel control characters is 0. 

Channel control character 01 corresponds to the top margin of a page. If you 
specified the Line number of the last line per page prompt as 66, you could 
specify the following: 


01 

- 1 

02 - 

5 

03 - 

10 

04 

-0 

05 

- 4 

06 - 

0 

07 - 

0 

08 

-0 

09 

- 0 

10 - 

0 

11 - 

0 

12 

-66 


If channel control character 01 is received, the printer will advance to line 1 
of the next page; if channel control character 02 is received, the printer 
advances to line 5 of the current page; channel control character 03 causes an 
advance to line 10 of the current page; channel control character 05 causes 
the printer to advance to line 4 on the next page; and channel control 
character 12 advances the form to line 66, the last line. All other channel 
control characters cause the printer to advance one line. 

Notes: 

1. These values can only be specified if a value has been specified for the Lines 
per page prompt. 

2. Under SNA, a received vertical tab table overrides the specifications made 
for the previous three prompts. 

If you had specified N (No) for the Spool? prompt on the previous display, you 
have completed defining a print entry. The entry menu is redisplayed. 

If you specified Y (Yes) for the Spool? prompt, continue with the next display. 
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MSRJE CONTROL TABLE UTILITY 


FORMFILE 

RESFORM1 



Create an MSRJE forms control table print entry 


Optional-* 


Hold in the spool file after printing?.N, Y N 

Begin printing when the job step ends?.Y,N Y 

Continue printing the same job stream?.N f Y N 

Number of copies to be printed . 1-255 * 

Priority on the spool file.0-5 1 

Expected activity of spooled print file . N,H,L,M N 


Cmd3-Save entry, display entry menu 

_ 


Cmd7-End of job, cancel entry 

(c) 1983 IBM Corp. 

_ J 


Note: This display is only presented if you have selected spooling for the printer 
output. 

Hold in spool file after printing?: Specify whether you want to keep the print output 
in the spool file after it has been printed. Y (Yes) specifies that you want the 
data kept in the file after it has been printed; N (No) specifies that the print 
data can be removed from the spool file after it has printed. N (No) is the 
default. 

Begin printing when the job step ends?: Specify whether the system should wait 
until the job step has been completed before it begins printing the data or 
whether it can begin printing the data before the job step ends. Y (Yes), the 
default, specifies that the system should wait. N (No) specifies that printing 
can begin before the job step ends. 

Continue printing the same job stream?: Specifies whether you want all output to 
the device printed as a single print step. This parameter is only used with the 
RJFILE procedure (see Chapter 6). 

Number of copies to be printed: Specify the number of copies of spooled output to 
be printed for the job step. Valid entries are any decimal number from 1 to 
255 or a blank. 

If a blank is specified (this is also the default) the number of copies printed is 
dependent on the protocol. For BSC MSRJE output, 1 is assumed. For SNA 
MSRJE output, the number of copies specified in the Peripheral Data 
Information Record (PDIR) received from the host system is used. 
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Priority on the spool file: Assigns a priority, from 0 through 5, to the spooled 
output. The system prints jobs in decreasing priority order. For example, 
print output with a priority of 5 is printed before other jobs on the spool file. 
Jobs with the same priority are printed in the same order they were written to 
the spool file. Priority 0 jobs are not printed until the system operator issues 
the RELEASE command to specifically release them for printing. If no 
priority is specified, 1 is assumed. 

Expected activity of the spooled print file: Specify how much activity you expect 
this spool file to have. The system uses the activity level to allocate system 
data area to the file. Valid entries are: 

• N for normal activity (the default) 

• H for high activity 

• L for low activity 

• M for medium activity 

A file with high activity requires the most system data area space. 

You have now completed defining a print entry. 

When creating, updating, or adding a print entry with output going to a printer, you 
will be prompted, when the printer parameters are complete, for any changes to the 
existing compressed disk file parameters. 



Compressed disk file creation information is put into each print entry. This 
information is used by MSRJE when it tries to print the data and the printer is not 
available. When the data is sent to a compressed disk file, it can be printed later by 
the RJFILE utility. 
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When reviewing a print entry with output going to a printer, you can also review 
the existing compressed disk file parameters. 


I 


You see line 0 if you are creating, updating, or adding to a print entry with output 
going to a printer. You see line 0 if you are reviewing a print entry. The 
compressed disk file information display appears at the end of all print entry input 
with output going to a printer. 
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Print Entry for Compressed Disk Output 


To create a print entry with output directed to a compressed disk file, you select 
option 1 (Create a new table) or option 3 (Add entries to an existing table) on the 
Control Table menu, and then select option 1 (Print) and option 3 (Compressed 
disk) on the entry menu. If you are updating an existing entry (option 2 on the 
Control Table menu), the current values are presented for the named entry on each 
of the displays. You can change any of those values. After you have entered the 
table entry name on the entry menu (the host forms name defines the entry in the 
table), the following display is presented. 



MSRJE CONTROL TABLE UTILITY 


Create an MSRJE forms control table compressed disk file entry 


FORMFILE 

RESFORM2 


Optional-* 


"\ 


Name of the file to be created . . , 

User ID.. 

Number of blocks to be reserved 
Number of blocks to extend the file 

Preferred disk location . 

Save the file in case of error? 

Add output to an existing file? 

Free unused file blocks? . 

Cmd3-Save entry, display entry menu 


. 1-312815 

. 0-312815 

A1,A2,A3,A4,block number 

.Y,N 

.N,Y 

.Y,N 

Cmd7-End of job, cancel 
(c) 


MSRJE 

MSRJE 

60 

10 

A1 * 

Y 
N 

Y 

entry 

1983 IBM Corp. 





Name of the file to be created: Specify the first 6 characters of the name of the file 
to be created when print output is written to a compressed disk file. MSRJE 
is the default name. 

The file is named as follows: 

xxxxxxnn 

where: 

xxxxxx is the value you specify for the Name of the file to be created 
prompt. 

nn is the printer file sequence number (as specified on display 36.0 
during MSRJE configuration) if the Add output to an existing file? 
prompt is specified as N (No). 

or 

nn is 00 if the Add output to an existing file? prompt is Y (Yes). 
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User ID: Specify the user ID to be used when output is being written to disk and 
resource security is active. The user ID can be from 1 to 8 characters; the 
default is MSRJE. 

Number of blocks to be reserved: Specify, in decimal, the number of blocks that are 
to be initially allocated for this file. Any number from 1 to 312815 is valid, 
but the specification cannot exceed the amount of available disk storage. The 
default is 60 blocks. 

Number of blocks to extend the file: Specify the number of blocks by which the file 
should be enlarged if the file becomes full. If 0 is specified, the file cannot be 
extended (enlarged). Any decimal value from 0 to 312815 can be specified; 
the default is 10. 

Preferred disk location: Specify either the disk on which you want the file placed or 
the block number at which the file should begin. The file is placed on the: 

• First disk if you specify Al, the default 

• Second disk if you specify A2 

• Third disk if you specify A3 

• Fourth disk if you specify A4 

Al, A2, A3, and A4 are only preferred locations. If the disk you specify is 
full or does not exist, the file is placed wherever there is room. 

A block number can be any 6-digit number less than 312815. Your file is 
placed at the block location you specify only if that location is available. 

Save the file in case of error?: Specify whether you want the data written to the file 
to be saved if an error occurs before the file is closed. Y (Yes), the default, 
specifies that if an error occurs before all data has been written to the file, the 
system will save the data already written to the file. N (No) specifies that the 
data already written will be lost if an error occurs before the file has been 
closed. 

Note: If you wish to add data to an existing file (see the next prompt), you 

should specify Y for this prompt. If you specify N and an error occurs, 
the entire file, including the data previously in the file, is deleted. 


# 
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Add output to an existing file?: Specify whether you want the print data received 
for this entry to be added to an existing compressed disk file. Y (Yes) 
specifies that you want the data added to file xxxxxxOO, where xxxxxx is the 
value specified for the Name of the file to be created prompt. N (No), the 
default, specifies that you want a new file created, and that file will be named 
xxxxxxnn, where xxxxxx is the value specified for the Name of the file to be 
created prompt, and nn is the print file sequence number. 

If you specify Y and a file by the specified name cannot be found, a new file 
will be created using that name. 

Note: Only one device can use the file at one time. 

Free unused file blocks?: Specify whether blocks that are not used by the file are to 
be released for use by other files. Specify Y (Yes), the default, or N (No). 
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You have now completed defining the compressed disk file for print output that is 
to be written to disk. You must still define the print information for the entry so 
that the disk file utility can print the data. Therefore, you are led through the 
remaining displays to define print information. 


MSRJE CONTROL TABLE UTILITY 
Create an MSRJE forms control table print entry 


Local forms name . 

Printer ID or SYSTEM . 

Align the forms before printing? . N,Y 

Spool?.Y,N 

Final quality printing? . N,Y 

Issue end of forms message?.Y,N 

Select a printwheel ID for the printer?.N, Y 


FORMFILE 

RESFORM2 

Optional-* 

* 


SYSTEM 

N 

Y 
N 

Y 
N 



Cmd3-Save entry, display entry menu 



Cmd7-End of job, cancel entry 

(c) 1985 IBM Corp. 
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Local forms name: Specify the forms name for the System/36 to which the 
received host forms name is to be translated. If no entry is made, no 
translation is done. 

Printer ID or SYSTEM: Specify the work station ID of the printer that is to print 
this output. If you intend to use the system printer, then specify SYSTEM. 
SYSTEM is the default. 

Align the forms before printing?: Specify whether you want the operator to have an 
opportunity to align the forms on the printer before the data begins printing. 
If you specify Y (Yes), the first line of output is printed and a message is 
issued. The operator can then align the form and select an option that causes 
the first line to print again and the same message to be displayed, or the 
operator can select an option that allows printing to continue with the second 
line of output. 

If N (No), the default, is specified, the output is printed without allowing the 
operator to align the forms. 

Spool?: Specify whether you want output controlled by this entry to be spooled. If 
you specify N (No), printer output controlled by this entry is not spooled, but 
is printed as it is received. If you specify Y (Yes), then the output can be 
written to the System/36 spool file instead of directly to the printer. If 
spooling is not active on System/36, this option is ignored. 
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Final quality printing?: Specify the print quality you want. If final quality printing N 
(No) is specified, and the print quality switch on the printer is set to draft 
quality, the output will be printed in draft quality. Any other combination 
causes the output to be printed in final quality. 

Issue end of forms message?: Specify Y (Yes) if you want an end of forms message 
to be sent to the console. 

Select a printwheel ID for the printer?: Specify Y (Yes) if you want to select a 
printwheel ID for the 5219 Printer. If you specify Y, the display that allows 
you to specify the option for the style of print that is to be put on the 5219 
Printer is shown. 


MSRJE CONTROL TABLE UTILITY 
Create an MSRJE forms control table print entry 

Select the option for the desired style of print 


FORMFILE 

RESFORM2 

Optional-* 


Style of print 

ID values 

Style of print 

ID values 

1 . 

Rhetoric 

05 

11 . 

Light Italic 

5b 

2. 

Courier 10 

OB 

12. 

Modern 

9E 

3. 

Prestige Pica 

OC 

13. 

Boldface 

9F 

4. 

Artisian 10 

0D 

14. 

Essay 

A0 

5. 

Pica 

14 

15. 

Essay Italic 

A2 

6. 

Symbol Scribe 

50 

16. 

Prestige 15 

DD 

7. 

Script 

54 

17. 

Gothic 15 

DE 

8. 

Courier 12 

55 

18. 

Courier 15 

DF 

9. 

Prestige Elite 

56 

19. 

Symbol Diplomat 

Scribe El 

10. 

Option 

Letter Gothic 

57 



1-19 


Cmd3-Save entry, display entry menu 


Cmd7-End of job, cancel entry 

(c) 1985 IBM Corp. 


Select the option for the desired style of print: If you entered Y to select a 

printwheel ID for the printer, you see a display on which you can select the 
desired style of print on the 5219 Printer. The default is specified through the 
CNFIGSSP procedure. The printwheel ID cannot be specified when 
characters per inch is specified on the following display. 
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The next display allows you to specify the format of the printed output, such as the 
number of lines per inch and inches per page to be printed. You also define how 
carriage control characters received from the host system in a print data stream are 
to be handled by the printer. 


MSRJE CONTROL TABLE UTILITY 


FORMFILE 

RESFORM2 


Create an MSRJE forms control table print entry 


Optional-* 

Lines per inch.4,6,8 * 

Characters per inch.10,15 * 

Lines per page.1-112 * 

Line number of the last line per page.1-112 * 

Line skips for forms: 

01-1 02-0 03-0 04-0 

05-0 06-0 07-0 08-0 

09-0 10-0 11-0 12-0 


"\ 


Cmd3-Save entry, save entry menu 



Cmd7-End of job, cancel entry 

(c) 1983 IBM Corp. 
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Lines per inch: This prompt is valid only for the following printers: 

• 5224 Models 1 and 2 

• 5225 Models 1, 2, 3, and 4 

Valid entries are 4, 6, or 8 lines per inch. If no entry is made, the current 
specification for the printer is used. 

Characters per inch: Specify whether you want the data printed at 10 or 15 
characters per inch. This prompt is valid only for the following printers: 

• 5224 Models 1 and 2 

• 5225 Models 1, 2, 3, and 4 

If no entry is made, the current specification for the printer is used. 

Note: You cannot use this prompt if you specified a printwheel ID on the 
previous display. 

Lines per page: Specify the number of lines on each page (the size of the forms). 
Valid entries are any decimal number from 1 to 112. If you do not enter a 
value, the current specification for the printer is used. 
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Line number of the last line per page: Specify the number of the last line to be 
printed on a page. Valid entries are any decimal number from 1 to 112, but 
the value must be equal to or greater than the specification made for the 01 
Line skip, and it must be less than or equal to the value specified for Lines per 
page. 

The default is the value specified for the Lines per page prompt or, if no value 
was specified for that prompt, the current lines per page specification for the 
printer. 

Note: If you did not specify a value for the Lines per page prompt, then you 
must not enter a value here. 

Line skips for forms: Specify which line on a page you want the printer to advance 
(skip) to when the corresponding channel control character is received. Up to 
12 entries (channel control characters 01 through 12) can be made. Each 
entry identifies a line number, and it must be less than or equal to the value 
specified for the Line number of the last line per page prompt. 

A channel control character whose assigned value is 0 causes the printer to 
advance one line. 

The default value for channel control character 01 is 1; the default for all 
other channel control characters is 0. 

Channel control character 01 represents the top margin of the page. If you 
had specified 66 for the Line number of the last line per page prompt, you 
could specify the following: 


01 

- 1 

02 

- 5 

03 - 

10 

04 - 

0 

05 

- 4 

06 

- 0 

07 - 

0 

08 - 

0 

09 

- 0 

10 

- 0 

1 1 - 

0 

12 - 

66 


If channel control character 01 is received, the printer will advance to line 1 
of the next page; if channel control character 02 is received, the printer 
advances to line 5 of the current page; channel control character 03 causes an 
advance to line 10 of the current page; channel control character 05 causes 
the printer to advance to line 4 on the next page; and channel control 
character 12 advances the form to line 66, the last line. All other channel 
control characters cause the printer to advance one line. 

Notes: 

1. These values can only be specified if a value has been specified for the Lines 
per page prompt. 

2. Under SNA, a received vertical tab table overrides the specifications made 
for the previous three prompts. 

If you had specified N (No) for the Spool? prompt on the previous display, you 
have completed defining a print entry. The entry menu is redisplayed. 
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If you specified Y (Yes) for the Spool? prompt, continue with the next display. 


MSRJE CONTROL TABLE UTILITY 
Create an MSRJE forms control table print entry 


FORMFILE 

RESFORM2 

Optional-* 


Hold in the spool file after printing?.N, Y N 

Begin printing when the job step ends?.Y,N Y 

Continue printing the same job stream?.N,Y N 

Number of copies to be printed . 1-255 * 

Priority on the spool file.0-5 1 

Expected activity of spooled print file . N,H,L,M N 


Cmd3-Save entry, display entry menu 



Cmd7-End of job, cancel entry 

(c) 1983 IBM Corp. 
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Note: This display is presented only if you have selected spooling for the printer 
output . 

Hold in the spool file after printing?: Specify whether you want to keep the print 
output in the spooled disk file after it has been printed. Y (Yes) specifies that 
you want the data kept in the file after it has been printed; N (No) specifies 
that the print data can be removed from the spooled file after it has printed. 

N (No) is the default. 

Begin printing when the job step ends?: Specify whether the system should wait 
until the job step has been completed before it begins printing the data or 
whether it can begin printing the data before the job step ends. Y (Yes), the 
default, specifies that the system should wait. N (No) specifies that printing 
can begin before the job step ends. 

Continue printing the same job stream?: Specify whether you want all output to the 
device printed as a single print step. This prompt is only used with the 
RJFILE (see Chapter 6) utility. 

Number of copies to be printed: Specify the number of copies of spooled output to 
be printed for the job step. Valid entries are any decimal number from 1 to 
255 or a blank. 

If a blank is specified (this is also the default) the number of copies printed is 
dependent on the protocol. For BSC MSRJE output, 1 is assumed. For SNA 
MSRJE output, the number of copies specified in the Peripheral Data 
Information Record (PDIR) received from the host system is used. 
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Priority on the spool file: Specify a priority, from 0 through 5, for the spooled 
output. The system prints jobs in decreasing priority order. For example, 
print output with a priority of 5 is printed before other jobs on the spooled 
file. Jobs with the same priority are printed in the same order they were 
written to the spool file. Priority 0 jobs are not printed until the system 
operator issues the RELEASE command to specifically release them for 
printing. If no priority is specified, 1 is assumed. 

Expected activity of spooled print file: Specify how much activity you expect this 
file to have. The system uses the activity level to allocate system data area to 
the file. Valid entries are: 

• N for normal activity (the default) 

• H for high activity 

• L for low activity 

• M for medium activity 

A file with high activity requires the most system data area space. 

You have now completed defining an entry for print output to a compressed disk 
file. 
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When creating, updating, or adding a print entry with output going to a printer, you 
will be prompted, when the printer parameters are complete, for any changes to the 
existing compressed disk file parameters. 



Compressed disk file creation information is put into each print entry. This 
information is used by MSRJE when it tries to print the data and the printer is not 
available. When the data is sent to a compressed disk file, it can be printed later by 
the RJFILE utility. 

When reviewing a print entry with output going to a printer, you can also review 
the existing compressed disk file parameters. 

You see line Q if you are creating, updating, or adding to a print entry with output 
going to a printer. You see line Q if you are reviewing a print entry. The 
compressed disk file information display appears at the end of all print entry input 
with output going to a printer. 
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One print default entry is defined for each control table file. This entry is used if 
there is no entry in the active control table that matches the received host forms 
name. Whenever you create a new table (option 1 on the Control Table menu), 
the control table utility automatically inserts a print default entry in that table. 
Therefore, you cannot create or add a print default entry but can update the 
existing entry, when you enter the Table entry name or leave it blank on the entry 
menu, a message is displayed telling you that the entry exists. Press the Enter key 
to update the entry. 

Updating a print default entry is the same as updating a print entry with printer 
output or a print entry with compressed disk output, except that option 2 (Print 
default entry) must be specified on the entry menu. 

You can remove a print default entry that you have updated. The control table 
automatically replaces the removed entry with the original entry containing the 
values supplied by IBM. 

The default values supplied by IBM are shown in Appendix D. 
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| Punch Entry for Disk File Output 


To create a punch entry with output directed to a disk file, select option 1 (Create 
a new table) or option 3 (Add entries to an existing table) on the Control Table 
menu, and then select option 3 (Punch) and option 2 (Disk file) on the entry menu. 
If you are updating an existing entry (option 2 on the Control Table menu), the 
current values are presented for the named entry on each of the displays. You can 
change any of those values. After you have entered the table entry name on the 
entry menu (the table entry name defines the entry in the table), the next display is 
presented. 

The first display allows you to define the characteristics of the file you want 
created. You can supply such information as the file name and type of file. 



Name of the file to be created: Specify the name of the file that is to be created by 
MSRJE. MSRJE is the default. The file is labeled xxxxxxnn, where xxxxxx is 
the value specified for this prompt, and nn is 00 if the data is to be added to 
an existing file, or nn is equal to the punch file sequence number as specified 
on display 36.0 during MSRJE configuration. 

User ID: When resource security is active on System/36, specify the user ID that 
is to be used when punch data is written to disk and when a procedure is 
started by MSRJE. The ID specified can be from 1 to 8 characters. 

| Procedure name: Specify the name of a System/36 procedure, if any, that should 

| be started by MSRJE after this punch data stream has been received. 

Library name: Specify the name of the System/36 library that contains the 
procedure specified for the previous prompt. 
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Type of file to be created: Specify whether you want MSRJE to create a sequential 
file (S, the default), a direct file (D), or an indexed file (I). 

Save the file in case of error?: Specify whether you want the data written to the file 
to be saved if an error occurs before the file is closed. Y (Yes), the default, 
specifies that if an error occurs before all data has been written to the file, the 
system will save the data already written to the file. N (No) specifies that the 
data already written will be lost if an error occurs before the file has been 
closed. 

Note: If you wish to add data to an existing file (see the next prompt), you 

should specify Y for this prompt. If you specify N and an error occurs, 
the entire file, including the data previously in the file, will be deleted. 

Add output to an existing file?: Specify whether you want the punch data received 
for this entry to be added to an existing disk data file. Y (Yes) specifies that 
you want the data added to file xxxxxxOO, where xxxxxx is the value specified 
for the Name of the file to be created prompt. N (No), the default, specifies 
that you want a new file created, and that file will be named xxxxxxnn, where 
xxxxxx is the value specified for the Name of the file to be created parameter, 
and nn is the punch file sequence number. 

If you specify Y and a file by the specified name cannot be found, a new file 
will be created using that name. 

Note: Only one device can use the file at one time. 

Free unused file blocks?: Specify whether blocks that are not used by the file can 
be released for use by other files. Specify Y (Yes), the default, or N (No). 

The next display allows you to specify additional characteristics of the file, such as 
the initial allocated disk space for the file and whether the file can later be 
expanded. 


MSRJE CONTROL TABLE UTILITY FORMFILE 

RESFORM3 

Create an MSRJE forms control table punch entry 

Optional-* 

Number of blocks to be reserved . 1-312815 60 

Number of blocks to extend the file.0-312815 10 

Preferred disk location.A1,A2,A3,A4,block number A1 * 

Record length in bytes . 1-4096 80 

Delete capable file?.N,Y N 


Cmd3-Previous menu, save entry 


Cmd7-End, cancel entry 

(c) 1983 IBM Corp. 
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Number of blocks to be reserved: Specify, in decimal, the number of blocks that are 
to be initially allocated for this file. Any number from 1 to 312815 is valid, 
but the specification cannot exceed the amount of available disk storage. The 
default is 60 blocks. 

Number of blocks to extend the file: Specify the number of blocks by which the file 
should be enlarged if the file becomes full. If 0 is specified, the file cannot be 
extended (enlarged). Any decimal value from 0 to 312815 can be specified; 
the default is 10. 

Preferred disk location: Specify either the disk on which you want the file placed or 
the block number at which the file should begin. The file is placed on the: 

• First disk if you specify Al, the default 

• Second disk if you specify A2 

• Third disk if you specify A3 

• Fourth disk if you specify A4 

Al, A2, A3, and A4 are only preferred locations. If the disk you specify is 
full or does not exist, the file is placed wherever there is room. 

A block number can be any 6-digit number less than 312815. Your file is 
placed at the block location you specify only if that location is available. 

Record length in bytes: Specify the size of the records that are to be written to the 
file. MSRJE always receives 80-character records. If the value you specify 
for the Record length in bytes prompt is not 80, MSRJE restructures the data 
into records of the size you specify. For example, if you specify 60 for the 
Record length in bytes prompt, three 80-character records received by MSRJE 
will be written to the file you are defining as four 60-character records. If 
you specify 160 for the Record length in bytes prompt, every two 80-character 
records received by MSRJE will be written to the file you are defining as one 
160-character record. 

Normally, the record length for a punch file is 80 or 96 bytes. The default 
record length for punch data directed to a data file is 80 bytes. 

Delete capable file?: Specify whether the file being created is to be a 

delete-capable file. Y specifies that it is; N, the default, specifies that it is not 
delete-capable. 
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If you specified a file type of S (sequential) or D (direct) for the Type of file to be 
created prompt, this completes your definition. The entry menu is displayed. If 
you specified a file type of I (indexed), you must complete one more display. 


r 


MSRJE CONTROL TABLE UTILITY 
Create an MSRJE forms control table punch entry 


FORMFILE 

RESFORM3 


Starting position of the key . 1-4096 1 

Length of the key.1-120 1 


Allow duplicate keys? 


N, Y N 


Cmd3-Save entry, display entry menu Cmd7-End of job, cancel entry 

(c) 1983 IBM Corp. 

_ _ J 


Starting position of the key: Specify the first position of the key within the record, 
which can be any value from 1 through 4096. The default is 1. 

Length of the key: Specify the number of bytes in the key. Any value from 1 
through 120 is valid. The default is 1. 

Note: The value specified for Starting position of the key plus the value specified for 
Length of the key minus 1 must be less than or equal to the defined record 
length. 

Allow duplicate keys?: Specify whether more than one record can have the same 
key value within the file. N (No), the default, specifies that duplicate keys 
are not allowed. Y (Yes) specifies that duplicate keys are allowed. 

If N is specified, duplicate key errors may occur since the host system can 
send duplicate header or trailer records to System/36. 

This completes the definition for a punch entry with output to a disk data file. The 
entry menu is displayed. 


Chapter 5. Creating and Maintaining Forms Control Tables 5-33 







Punch Entry for Compressed Disk Output 


To create a punch entry with output directed to a compressed disk file, select 
option 1 (Create a new entry) or option 3 (Add entries to an existing file) on the 
Control Table menu, and then select option 3 (Punch) and option 3 (Compressed 
disk) on the entry menu. If you are updating an existing entry (option 2 on the 
Control Table menu), the current values are presented for the named entry on each 
of the displays. You can change any of those values. After you have entered the 
Table entry name on the entry menu (the table entry name defines the entry in the 
table), the following display is presented. 


MSRJE CONTROL TABLE UTILITY 
Create an MSRJE forms control table compressed disk file entry 


FORMFILE 

RESFORM4 


Optional*-* 


Name of the file to be created . . 

User ID . 

Number of blocks to be reserved 
Number of blocks to extend the file 

Preferred disk location . 

Save the file in case of error? 

Add output to an existing file? 

Free unused file blocks? . 

Cmd3-Save entry, display entry menu 



. 1-312815 

. 0-312815 

A1,A2,A3,A4 f block number 

.Y,N 

.N,Y 

.Y,N 

Cmd7-End of job, cancel 
(c) 


MSRJE 

MSRJE 

60 

10 

A1 * 

Y 
N 

Y 

entry 

1983 IBM Corp. 
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Name of the file to be created: Specify the first 6 characters of the name of the file 
to be created when punch output is written to a compressed disk file. MSRJE 
is the default name. 

The file will be named as follows: 

xxxxxxnn 

where: 

xxxxxx is the value you specify for the Name of the file to be created 
prompt. 

nn is the punch file sequence number (as specified on display 36.0 
during MSRJE configuration) if the Add output to an existing file? 
prompt is specified as N (No). 

or 

nn is 00 if the Add output to an existing file? prompt is Y (Yes). 
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User ID: Specify the user ID to be used when output is being written to disk and 
resource security is active. The user ID can be from 1 to 8 characters; the 
default is MSRJE. 

Number of blocks to be reserved: Specify, in decimal, the number of blocks that are 
to be initially allocated for this file. Any number from 1 to 312815 is valid, 
but the specification cannot exceed the amount of available disk storage. The 
default is 60 blocks. 

Number of blocks to extend the file: Specify the number of blocks by which the file 
should be enlarged if the file becomes full. If 0 is specified, the file cannot be 
extended (enlarged). Any decimal value from 0 to 312815 can be specified; 
the default is 10. 

Preferred disk location: Specify either the disk on which you want the file placed or 
the block number at which the file should begin. The file is placed on the: 

• First disk if you specify Al, the default 

• Second disk if you specify A2 

• Third disk if you specify A3 

• Fourth disk if you specify A4 

Al, A2, A3, and A4 are only preferred locations. If the disk you specify is 
full or does not exist, the file is placed wherever there is room. 

A block number can be any 6-digit number less than 312815. Your file is 
placed at the block location you specify only if that location is available. 

Save the file in case of error?: Specify whether you want the data written to the file 
to be saved if an error occurs before the file is closed. Y (Yes), the default, 
specifies that if an error occurs before all data has been written to the file, the 
system will save the data already written to the file. N (No) specifies that the 
data already written will be lost if an error occurs before the file has been 
closed. 

Note: If you wish to add data to an existing file (see the next prompt), you 

should specify Y for this prompt. If you specify N and an error occurs, 
the entire file, including the data previously in the file, is deleted. 
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Add output to an existing file?: Specify whether you want the punch data received 
for this entry to be added to an existing compressed disk file. Y (Yes) 
specifies that you want the data added to file xxxxxxOO, where xxxxxx is the 
value specified for the Name of the file to be created prompt or MSRJE. N 
(No), the default, specifies that you want a new file created, and that file will 
be named xxxxxxnn, where xxxxxx is the value specified for the Name of the 
file to be created prompt, and nn is the punch file sequence number. 

If you specify Y and a file by the specified name cannot be found, a new file 
will be created using that name. 

Note: Only one device can use the file at one time . 

Free unused file blocks?: Specify whether blocks that are not used by the file are to 
be released for use by other files. Specify Y (Yes), the default, or N (No). 
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Once you have completed the definition for the compressed disk file, you define 
the characteristics of a data file so that the RJFILE utility (see Chapter 6) can 
convert the compressed file to a data file usable by your programs. The following 
sequence of displays is presented. 


MSRJE CONTROL TABLE UTILITY 
Create an MSRJE forms control table punch entry 


Name of the file to be created . . 

User ID . 

Procedure name . 

Library name . 

Type of file to be created .... 
Save the file in case of error? 

Add output to an existing file? 

Free unused file blocks? . 

Cmd3-Save entry, display entry menu 



. S,D,I 

.Y,N 

.N,Y 

.Y,N 

Cmd7-End of job, cancel 
(c) 


FORMFILE 

RESF0RM4 

Optional-* 

MSRJE 

MSRJE 


#LIBRARY 

S 

Y 


N 

Y 

entry 

1983 IBM Corp. 


Name of the file to be created: Specify the first 6 characters of the name of the file 
that is to be created by MSRJE. MSRJE is the default name. 

The file will be named as follows: 

xxxxxxnn 

where: 

xxxxxx is the value you specify for the Name of the file to be created prompt. 

nn is the punch file sequence number (as specified on display 36.0 during 
MSRJE configuration) if the Add output to an existing file? prompt is 
specified as N (No) 

or 

nn is 00 if the Add output to an existing file? prompt is Y (Yes). 
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User ID: When resource security is active on System/36, specify the user ID that 
is to be used when punch data is written to disk and when a procedure is 
started by MSRJE. The ID specified can be from 1 through 8 characters. 

Procedure name: Specify the name of a System/36 procedure, if any, that should 
be started by MSRJE or RJFILE after this punch data stream has been 
received. 

Library name: Specify the name of the System/36 library that contains the 
procedure specified for the previous prompt. 

Type of file to be created: Specify whether you want MSRJE to create a sequential 
file (S, the default), a direct file (D), or an indexed file (I). 

Save the file in case of error?: Specify whether you want the data written to the file 
to be saved if an error occurs before the file is closed. Y (Yes), the default, 
specifies that if an error occurs before all data has been written to the file, the 
system will save the data already written to the file. N (No) specifies that the 
data already written will be lost if an error occurs before the file has been 
closed. 

Note: If you wish to add data to an existing file (see the next prompt), you 

should specify Y for this prompt. If you specify N and an error occurs, 
the entire file, including the data previously in the file, is deleted. 

Add output to an existing file?: Specify whether you want the punch data received 
for this entry to be added to an existing disk data file. Y (Yes) specifies that 
you want the data added to file xxxxxxOO, where xxxxxx is the value specified 
for the Name of the file to be created prompt. N (No), the default, specifies 
that you want a new file created, and that file will be named xxxxxxnn, where 
xxxxxx is the value specified for the Name of the file to be created prompt, 
and nn is the punch file sequence number. 

If you specify Y and a file by the specified name cannot be found, a new file 
will be created using that name. 

Note: Only one device can use the file at one time. 

Free unused file blocks?: Specify whether blocks that are not used by the file can 
be released for use by other files. Specify Y (Yes), the default, or N (No). 
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MSRJE CONTROL TABLE UTILITY FORMFILE 

RESFORM4 

Create an MSRJE forms control table punch entry 

Optional-* 

Number of blocks to be reserved . 1-312815 60 

Number of blocks to extend the file.0-312815 10 

Preferred disk location . A1,A2,A3,A4,block number A1 * 

Record length in bytes . 1-4096 80 

Delete capable file?.N,Y N 


Cmd3-Save entry, display entry menu 


Cmd7-End of job, cancel entry 

(c) 1983 IBM Corp. 


Number of blocks to be reserved: Specify, in decimal, the number of blocks that are 
to be initially allocated for this file. Any number from 1 to 312815 is valid, 
but the specification cannot exceed the amount of available disk storage. The 
default is 60 blocks. 

Number of blocks to extend the file: Specify the number of blocks by which the file 
should be enlarged if the file becomes full. If 0 is specified, the file cannot be 
extended (enlarged). Any decimal value from 0 to 312815 can be specified; 
the default is 10. 

Preferred disk location: Specify either the disk on which you want the file placed or 
the block number at which the file should begin. The file is placed on the: 

• First disk if you specify Al, the default 

• Second disk if you specify A2 

• Third disk if you specify A3 

• Fourth disk if you specify A4 

Al, A2, A3, and A4 are only preferred locations. If the disk you specify is 
full or does not exist, the file is placed wherever there is room. 

A block number can be any 6-digit number less than 312815. Your file is 
placed at the block location you specify only if that location is available. 
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Record length In bytes: Specify the size of the records that are to be written to the 
file. MSRJE always receives 80-character records. If the value you specify 
for the Record length in bytes prompt is not 80, MSRJE restructures the data 
into records of the size you specify. For example, if you specify 60 for the 
Record length in bytes prompt, three 80-character records received by MSRJE 
will be written to the file you are defining as four 60-character records. If 
you specify 160 for the Record length in bytes prompt, every two 80-character 
records received by MSRJE will be written to the file you are defining as one 
160-character record. 

Normally, the record length for a punch file is 80 or 96 bytes. The default 
record length for punch data directed to a data file is 80 bytes. 

Delete capable file? Specify whether the file being created is to be a delete-capable 
file. Y specifies that it is; N, the default, specifies that it is not 
delete-capable. 
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If you specified a file type of S (sequential) or D (direct) for the Type of file to be 
created prompt, this completes your definition. The entry menu is displayed. If 
you specified a file type of I (indexed), you must complete one more display. 


MSRJE CONTROL TABLE UTILITY 
Create an MSRJE forms control table punch entry 


FORMFILE 

RESFORM4 


'\ 


Starting position of the key . 1-4096 1 

Length of the key.1-120 1 

Allow duplicate keys?.N,Y N 


Cmd3-Save entry, display entry menu Cmd7-End of job, cancel entry 

(c) 1983 IBM Corp. 

V_ _ J 


Starting position of the key: Specify the first position of the key within the record, 
which can be any value from 1 through 4096. The default is 1. 

Length of the key: Specify the number of bytes in the key. Any value from 1 
through 120 is valid. The default is 1. 

Note: The value specified for Starting position of the key plus the value specified for 
Length of the key minus 1 must be less than or equal to the defined record 
length. 

Allow duplicate keys?: Specify whether more than one record can have the same 
key value within the file. N (No) the default, specifies that duplicate keys are 
not allowed. Y (Yes) specifies that duplicate keys are allowed. 

If N is specified, duplicate key errors may occur since the host system can 
send duplicate header or trailer records to System/36. 

This completes the definition for a punch entry with output to a compressed disk 
file. The entry menu is displayed. 
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Punch Default Entry 


One punch default entry is defined for each control table. This entry will be used if 
there is no entry in the active control table that matches the received host forms 
name. Whenever you create a new table (option 1 on the Control Table menu), 
the control table utility automatically inserts a punch default entry in that file. 
Therefore, you cannot create or add a punch default entry, but can update the 
existing entry. When you enter the Table entry name, or leave it blank, on the entry 
menu, a message is displayed telling you that the entry exists. Press the Enter key 
to update the entry. 

Updating a punch default entry is the same as updating a punch entry with data file 
output or a punch entry with compressed disk output, except that option 4 (Punch 
default entry) must be specified on the entry menu. 

You can remove a punch default entry that you have updated. The control table 
automatically replaces the removed entry with the original entry containing the 
values supplied by IBM. 

The default values supplied by IBM are shown in Appendix D. 
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Chapter 6. MSRJE Disk File Utility 


The MSRJE disk file utility (RJFILE) allows you to convert punch data that was 
written to a compressed disk file (a file with 256-byte unprocessed records) by 
MSRJE to files that you define. You can also use RJFILE to print files that 
contain print data written by MSRJE to a compressed disk file. 

The disk file utility requires the following: 

• Disk files containing 256-byte unprocessed records as created by MSRJE. 

• Utility control statements. 

• A forms control table to control the output of RJFILE (optional). 


Disk File Input to the Disk File Utility 

Input to the disk file utility can be: 

• Punch files, created by an MSRJE session, that contain 256-byte unprocessed 
records. These files can be converted to disk data files using RJFILE. 

• Print files, created by an MSRJE session, that contain 256-byte unprocessed 
records. These files can be printed using RJFILE. 

A single file can contain both print and punch data. 

Starting the Disk File Utility 


The MSRJE disk file utility can be run by either entering the RJFILE procedure 
command or by entering the OCL statements needed by the utility. 
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Using the RJFILE Procedure Command 


The RJFILE procedure command is used to start the MSRJE disk file utility. The 
format of the procedure command is: 

RJFILE filename[,control-table-name] 

filename: Specifies the name of the disk file that is to be converted or printed using 
RJFILE. 

If the filename parameter is not specified, you will be prompted for the input 
file name. If the RJFILE procedure is entered from the job queue, the 
filename parameter must be specified on the procedure command. If it is not, 
a message is displayed at the system console, and the job canceled. 

control-table-name: Specifies the name of the control table that RJFILE is to use 
to control the conversion or printing. The control table named must have 
been created using the control table utility. The control table utility is 
described in Chapter 5. 

If you do not specify the control-table-name parameter, the disk file utility 
uses the default values for print or punch data as described in Appendix D. 

Using OCL Statements to Run the Disk File Utility 

If you prefer, you can enter OCL statements to run the MSRJE disk file utility. 

The following statements are needed: 

// LOAD #RJFILE 

// RUN 

// COPYFILE NAME-filename[,DATE-date][,CTNAME-name] 

// END 

The COPYFILE statement specifies the file that is to be used as input to the utility 
and specifies the name of the file that contains the control table to be used by the 
RJFILE procedure. The parameters are: 

NAME: Specifies the name of the file created by MSRJE that is to be used as 
input to the disk file utility. 

DATE: Specifies the creation date of the file to be used as input. The date must 
be entered in the system date format. If no date is entered, the named file 
with the latest creation date is used. 

CTNAME: Specifies the name of the file that contains the control table, as created 
by the MSRJE control table utility, that is to be used to control creating a 
disk file from punch data or printing print data. If the CTNAME parameter is 
not specified, the disk file utility uses the IBM-supplied default values for 
print or punch data, as described in Appendix D. 

You can enter as many COPYFILE statements as needed to process your input 
files. All COPYFILE statements must be placed before the END statement. 
User-written procedures can also specify multiple COPYFILE statements. 
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Chapter 7. Defining MSRJE to a BSC Host System 


This chapter contains information that is needed by the host system programmer to 
properly configure a communications network that includes System/3 6 running 
MSRJE. The information given here is intended to point out those items that are 
needed to support MSRJE; it is not intended to be a reference document for 
configuring a host system. Changes to the parameters and their default values 
sometimes occur between releases. Therefore, the information given here may not 
exactly reflect the host subsystem release with which you are operating. 


System Components 

When MSRJE is used with a BSC data link, System/36 is the remote station in the 
communications network and initiates communications with the host system by 
sending a logon/signon sequence. Communications can be over a point-to-point 
switched or leased line. 

BSC MSRJE supports communications with the following host subsystems: 

• OS/VS2 Job Entry Subsystem 2 (JES2) 

• OS/VS2 Job Entry Subsystem 3 (JES3) 

• OS/VS1 Remote Entry Services (RES) 

• VM/370 Remote Spooling Communications Subsystem (RSCS) 

MSRJE with a BSC data link requires the following components on the host 
system: 

• 270x or 37xx Communications Controller and Network Control Program 
(NCP). 

• Appropriate communications access method (depending on the host 
subsystem). 

• An operating system (OS/VS1 or OS/VS2 (MVS)). 

The relationship of these components to each other is shown in Figure 7-1. 
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Communications Controller and the NCP 


The IBM 37xx Communications Controllers provide communications control by 
means of the Network Control Program (NCP). A communications controller and 
its NCP support a variety of remote terminals attached to the controller. The NCP 
is generated from a series of user-specified macroinstructions. An NCP can be 
generated to handle lines in either network control mode, or emulation mode, or 
both. An NCP that is generated with both kinds of functions is called an NCP with 
the Partitioned Emulation Programming (PEP) extension. 

Remote Terminal Access Method (RTAM), JES2, and JES3 use the facilities of the 
NCP to control lines and devices attached to the controllers, to transmit and 
receive data, and to perform error recovery. Virtual Telecommunications Access 
Methods (VTAM) executes macroinstructions to direct the acquisition, reading, 
writing and checking of data from the terminals to which it is connected. 

For additional information on the communications controllers and the NCP, see the 
Introduction to the IBM 3704 and 3705 Communications Controllers. 


Communications Access Methods 


RTAM 

RTAM is a communications access method used by RES for BSC operations. All 
work stations, communications line, and transmission code dependencies are 
resolved by RTAM. 

RTAM is started on a communications line basis rather than on a work station 
basis. To initiate processing, the central operator issues a START RTAM 
command, which, in turn, starts one or more communications lines. Additional 
lines can be started later by entering a MODIFY command specifying lines that 
were previously allocated to RTAM. Any work station compatible with the line 
adapter and data set (for switched lines) attached to the line can establish 
connection with RES through a LOGON procedure that identifies the particular 
work stations or work station user. 

JES2 


The Remote Job Entry (RJE) facility of JES2 allows remote work stations to use 
the Job Entry Subsystem. To initiate processing, the system operator starts one or 
more lines by entering the $S Start command. Any work station compatible with 
the line adapter and data set (for switched lines) attached to the line can establish 
connection with JES2 through a SIGNON procedure that identifies the particular 
work station or work station user. JES2 uses RTAM to provide an interface 
between JES2 and the remote work station. 
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JES3 


JES3 uses RTAM to provide an interface between JES3 and the remote work 
station. RTAM provides blocking/deblocking, compression/decompression, and 
synchronization with the remote terminal. To initiate processing, the system 
operator enters a * START LINE command. Any work station compatible with the 
line adapter and data set (for switched lines) attached to the line can establish 
connection with JES3 through a SIGNON procedure that identifies the work 
station or work station user. 


VM/370 RSCS 


The SML (Spool MULTILEAVING) line driver operates as a task under the RSCS 
component of VM/370, and provides VM/370 with the support for the 
MULTILEAVING binary synchronous communications line protocol for 
programmable remote work stations. 

The SML line driver, when communicating with System/36 MSRJE, functions in a 
host mode. In host mode, SML follows a common protocol for all remote work 
stations. 
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JES2 Host System Generation 


When JES2 is started, a series of initialization parameters are processed to 
determine the configuration options to be used. Initialization parameters that are 
required for System/36 RJE work stations can be characterized as: (1) 
system-wide initialization values and (2) remote work station definitions. 

JES2 System-Wide Initialization Parameters 

The following JES2 system-wide initialization parameters are used to define BSC 
work stations running RJE. For a complete description of JES2 initialization 
parameters, see the manual OS /VS2 MVS System Programming Library: 
Initialization and Tuning. 

&MLBFSIZ=nnnn (MULTILEAVING Buffer Size): Specifies the size, in bytes, of 
each JES2 MULTILEAVING buffer. The value specified must match the value 
specified for the prompt Buffer length on display 11.0 during line member 
configuration at System/36. 

Default: 400 

&NUMBUF=nnnn (JES I/O Buffer Count): Specifies the number (15 through 
2000) of I/O buffers to be included in the JES2 load module. Refer to OS/VS2 
MVS System Programming Library: Initialization and Tuning for information on 
calculating this value. 

&NUMCMBS=nnnn (Number of JES2 Console Message Buffers): Specifies the 
number (3 through 999) of console message buffers to be provided for JES2. 
When RJE is used, more buffers are usually needed; this is especially true with 
console support for MULTILEAVING terminals. Specifying too few message 
buffers can cause serious performance degradation. 

During periods of high console activity when no message buffers are available, 
certain noncritical JES2 messages are discarded. 

For a MULTILEAVING terminal console, if more messages are queued than the 
number of buffers specified in this parameter, excess messages are spooled and 
printed later. 

Default: 15 
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&NUMJOES=nnnn (Number of Job Output Elements): Specifies the number of 
job output elements to be generated. One job output element is required for each: 

• Unique punch or print class that appears in a job that is queued for output. 

• Active printer or punch. 

• Interrupted or restarted job that is not currently active on printer or punch. 

• Unique combination of forms ID, USCID, and FCB ID for all jobs currently 
queued for output. 

• Job that was interrupted by a system failure while being printed or punched 
and has not yet been warm started on an output device. 

Specifying too small a value results in jobs waiting for in-storage queuing in order 
to complete active print or punch work. For performance, you should specify a 
number slightly larger than the total of the above elements. 

Default: 10 times the total number of local and remote printers and punches. 

&NUMLNES=nnnn (Number of Teleprocessing Lines): Specifies the maximum 
number of LINEnnn initialization parameters that can be specified. This value 
includes the number of lines defined either as BSC MULTILEAVING lines or as 
logical lines for SNA. 

Default: 0 

&NUMRJE=nnnn (Number of Remote Terminal Definitions): Specifies the number 
(0 through 255) of remote terminal definitions (RMTnnn). This value should 
correspond to the highest number used as an RMTnnn initialization parameter. 

Default: The value specified for the &NUMLNES parameter. 

&PRTRANS=YES/NO (Print Line Translation Option): Specifies whether to 
translate lines of print directed to remote printers. If the default value (yes) is 
used, each line to be printed is translated by changing: 

• Lowercase to uppercase 

• Characters that are invalid on a part-numbered print train to blanks 

If any print train on a remote printer has characters not equivalent to those on a 
part-numbered train, NO must be specified. 

In BSC, if the remote printer is on a nontransparent line, translation occurs 
regardless of the value specified for &PRTRANS. 

Default: YES. 
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&SPOLMSG=nnn (Remote Terminal Spool Message Record Count): Specifies the 
number (0 through 254) of physical records to be reserved for operator messages 
and JES2 messages for each JES2 remote terminal. 

Default: (4096/&BUFSIZE) x 6 if &NUMLNES is not 0; 

0 if &NUMLNES is 0. 

&TPBFSIZ=nnnn (Teleprocessing Buffer Size): Specifies the largest 
telecommunications buffer size in bytes required for any remote work station. 
During initialization, JES2 adjusts the &TPBFSIZ value to equal the &MLBFSIZ. 

Default: 400 

&TPIDCT=nnn (Remote Printer Separator Page Line Count): Specifies the number 
(0 through 255) of print lines that are to appear on each JES2 job output separator 
page for remote terminal printers. If the specification is 30 or greater, the first 29 
lines are used to produce a block-lettered job name, job number, and SYSOUT 
class. 

Default: 6 

&WAITIME=nn (Remote Terminal Function Interval): Specifies the length of time 
in seconds (1 through 30) JES2 waits after processing an input stream or output 
stream to allow entry of commands or jobs by the MSRJE operator. 

Default: 1 
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Remote Work Station Definitions for BSC MULTILEAVING 


JES2 remote work station definitions for BSC MULTILEAVING consist of a 
series of LINEnnn, RMTnnn, Rnnn.PRm, Rnnn.PUm, and Rnnn.RDm parameters. 


LINEnnn (Line Definition) 


The LINEnnn parameter defines the characteristics of one telecommunications line 
to be used during remote job entry. This parameter must be specified for each line. 

nnn specifies an identification number for the line. All lines must have a unique 
number in the range 1 through 255 that is equal to or less than the value specified 
for &NUMLNES. Do not use leading zeros for nnn. 

The following LINEnnn subparameters are used in defining BSC 
MULTILEAVING work stations. 

HISPEED/LOWSPEED: Specify LOWSPEED (less than or equal to 9600 bits 
per second). 

Default: LOWSPEED, which specifies that this is a low-speed line (less than or 
equal to 9600 bits per second). 

PASSWORD=ccccccccc: Specifies a security password to prevent unauthorized 
work stations from using this line. The value specified (1 through 8 alphameric 
characters) must match the entry made for the passwordl parameter of the 
SIGNON command on display 35.0 during MSRJE subsystem configuration at 
System/36. 

Default: No password. 

TRANSP/NOTRANSP: Specifies whether transparent data is to be transmitted 
(any 8-bit character). 

Default: NOTRANSP, which specifies that the text transparency feature of the 
BSC adapter is not present on this line. 

USASCII/EBCDIC: You must specify EBCDIC. 

Default: EBCDIC, which specifies that the BSC adapter is configured for 
EBCDIC line control characters. 
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RMTnnn (Remote Work Station Definition) 


The RMTnnn parameter specifies the characteristics of one remote work station. 
One RMTnnn parameter is required for each work station. 

nnn specifies an identification number for the work station. Work stations are 
numbered consecutively from 1 through 255. Do not use leading zeros for nnn. 

The highest value specified for nnn must match the value specified for &NUMRJE. 

The following subparameters of RMTnnn are used in defining BSC 
MULTILEAVING work stations. 

SYSTEM/3: Specifies that MSRJE functions as a System/3. 

CONSOLE/NOCON: CONSOLE specifies that this work station has an operator 
console or that it is simulating a console. 

Because System/36 supports a console, specify CONSOLE. 

Default: NOCON, which specifies that this work station has no operator console. 

DISCINTV=nnnn: Specify DISCINTV=0 (a 0 specifies this work station is not to 
be disconnected if there is no text transmission in either direction). 

Default: 0, which specifies that this terminal is not to be disconnected. 

FIXED/VARIABLE Specify VARIABLE (variable data record length). 

Default: VARIABLE. 

MULTI/HARDWARE: MULTI specifies that this terminal will use the BSC 
MULTILEAVING interfaces. If MULTI is specified, the terminal type must 
specify MULTILEAVING work stations. 

Default: HARDWARE, which specifies that this terminal will not use the BSC 
MULTILEAVING interfaces. 

NUMPR=n: Specifies the number of printers at this remote terminal. Specify from 
0 through 7 for System/36. The value specified here should not be greater than 
the value entered for the prompt Maximum number of printers on display 36.0 
during MSRJE subsystem configuration at System/36. 

Default: 1 

NUMPU=n: Specifies the number of punch devices at this remote terminal. 
Specify from 0 through 7 for System/36. The value specified here should not be 
greater than the value entered for the prompt Maximum number of punches on 
display 36.0 during MSRJE subsystem configuration at System/36. 

Default: 0 

Note: The total number of printers (NUMPR) and punches (NUMPU) cannot 
exceed 8. 
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NUMRD=n: Specifies the number of readers at this remote terminal. Specify 
from 1 through 7 for System/36. This value must be at least as large as the value 
entered for the prompt Maximum number of host readers on display 37.0 during 
MSRJE subsystem configuration at System/36. 

Default: 1 

PASSWORD=ccccccccc: Specifies a security password (1 through 8 alphameric 
characters) to prevent unauthorized terminals from using this remote terminars 
resources. If used, this entry must match the entry made for the password2 
parameter of the SIGNON command on display 35.0 during MSRJE subsystem 
configuration at System/36. 

Default: No password. 

ROUTECDE==nnn: Specifies the route code to be assigned to this terminal and its 
associated printers, punches, and readers. The value of nnn may be any number 
from 1 through the value of &NUMRJE. 

Default: If a route code is not specified, JES2 assigns the number of this terminal 
(RMTnnn) as its route code. 

SETUPINF/SETUPACT: SETUPINF specifies that operator setup messages 
issued at the local (CPU) console for this remote device are to be informational 
messages (they do not require an operator action to be deleted from a display 
console). Specify SETUPINF for System/36. 

Default: SETUP ACT, which specifies that operator setup messages issued at the 
local console for this remote device are flagged as action messages (requiring a 
operator action to be deleted from a display console). 

TRANSP/NOTRANSP: TRANSP specifies that this terminal has the text 
transparency feature. To be effective, the TRANSP subparameter must also be 
specified for the line (LINEnnn initialization parameter) being used. Specify 
TRANSP here only if the prompt Transparency? on display 37.0 during MSRJE 
subsystem configuration at System/36 was responded to with Y (Yes). 

Default: NOTRANSP, which specifies that this terminal does not have the text 
transparency feature. 
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Rnnn.PRm (Remote Printer Definition) 


The Rnnn.PRm parameter specifies the characteristics of one printer at a remote 
work station. 

nnn specifies the number of the work station as specified in an RMTnnn 
initialization parameter. This associates the printer with this work station. 

m specifies the number of this printer. 

The number of printers defined using the Rnnn.PRm parameter must match the 
number of printers specified for the NUMPR subparameter of the RMTnnn 
parameter. 

The following subparameters further define the remote work station printer. 

AUTO/OPERATOR: AUTO specifies that this printer is to operate initially in 
automatic (demand) forms mode when JES2 starts processing. Specify AUTO for 
System/36. 

Default: OPERATOR which specifies that this printer is to operate initially in 
operator controlled (forms) mode. 

The mode may be modified from the remote terminal via the JES2 $T set 
command. 


7-14 Multiple Session Remote Job Entry Guide 



CKPTLNS=nnnnn: Specifies the maximum number of lines (0 through 32767) in a 
page. The size of a logical page is also defined as the number of lines printed until: 

• A channel skip is encountered. 

• The line count specified by &LINECT, the /*JOBPARM control statement, or 
the JOB statement accounting field has been exceeded. 

If CKPTLNS is 0, a logical page is defined only by the preceding items. 

If the line count does not equal 0, setting CKPTLNS to a value greater than line 
count results in the line count being used as the definition of a logical page; it 
overrides CKPTLNS. 

CKPTLNS, in conjunction with CKPTPGS, is used to specify the checkpoint 
interval for data sets having a line count of 0 and no channel skips. 

Default: 0 

CKPTPGS=nnnnn: Specifies the number of logical pages (1 through 32767) to be 
printed before each checkpoint is taken. 

The CKPTPGS and CKPTLNS parameters determine the number of logical 
records sent to the remote before a checkpoint is taken. The number of records 
sent equals CKPTPGS times CKPTLNS. The checkpoint is not taken until JES2 
receives acknowledgement that the remote terminal successfully received the data. 

Default: 1 
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CLASS=cl...cn: Specifies the output classes, in priority sequence, to be processed 
initially by this printer. You can specify any number of classes (A through Z and 0 
through 9) up to the maximum number of classes specified by the &NUMCLAS 
parameter. 

Default: AJ (where A and J are classes assigned to this printer). 

DRAIN/START DRAIN specifies that this printer is to be started by operator 
command. START, which specifies that the printer is to be started automatically 
when JES2 starts processing, should be specified for System/36. 

Default: START. 

FORMS=cccc: Specifies the forms identifier of the forms that are assumed to be 
initially loaded in this printer (1 through 4 alphameric characters). 

Default: If no value is specified, JES2 will use the forms identifier specified by the 
&STDFORM generation parameter. 

LIMIT=(m-n,m-*): The LIMIT subparameter allows you to specify that output is 
to be selected for specific printers based upon the amount of the output (in 
records). The values m and n specify within what output size range (in records) a 
job output element (JOE) must fall to be processed by this printer. The integer m 
specifies the lower output size limit and n specifies the upper output size limit. The 
value of m must be less than the value of n. The maximum value that can be 
explicitly assigned to n is 999999 records. If * is specified, the upper limit is set to 
the default value of n (4294767295). 

Default: m equals 0, and n equals 4294767295. 

NOSEP/SEP: NOSEP specifies that separator pages are not to be provided 
initially between data set groups. 

Default: SEP, which specifies that separator pages are to be provided initially 
between data set groups. 

Note: If 0 print lines were specified by the &TPIDCT parameter , separator pages 
will not be produced even if SEP is specified. 


I 


Default: 120 

ROUTECDE=nnn: Specifies the route code (1 through 255) to be assigned to this 
printer. The route code specified may be that of any remote terminal defined to 
JES2 by the RMTnnn initialization parameter. 

Default: JES2 assigns the route code of the remote terminal to which the printer is 
attached. (See the description of the RMTnnn parameter in this chapter for more 
information about the route code). 


PR WIDTH=nnn: Specifies the maximum number of characters to be printed on 
one line. Specify 198 only if you are using a forms control table entry with a 
printwheel ID which has a CPI=15, or if you are using a print image of CPI=15 
when using a printer which supports a CPI= 15. Specify 132 if you are not using a 
printwheel ID which has a CPI=15. 
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Riuin.PUm (Remote Card Punch Definition) 


The Rnnn.PUm parameter specifies the characteristics of one punch at a remote 
work station. 

nnn specifies the number of the work station as specified in an RMTnnn 
initialization parameter. This ties the punch to a work station. 

m specifies the number of this punch. 

The number of punches defined using the Rnnn.PRm parameter must match the 
number of punches specified for the NUMPU subparameter of the RMTnnn 
parameter. 

The following subparameters are used to further define the remote card punch. 

AUTO/OPERATOR: AUTO, which specifies that this punch is to operate initially 
in automatic (demand) forms mode when JES2 starts processing, should be 
specified for System/36. 

Default: OPERATOR, which specifies that this punch is to operate initially in 
operator controlled (forms) mode. The mode may be modified from the remote 
terminal via the JES2 $T set command. 

CKPTLNS=nnnnn: Specifies the maximum number of cards (0 through 32767) to 
be punched per logical page. 

CKPTLNS is the only value used to define a logical page for punches. 

Default: 100 

CKPTPGS=nmmn: Specifies the number of logical pages (1 through 32767) to be 
punched before each checkpoint is taken. 

The CKPTPGS and CKPTLNS parameters determine the number of logical 
records sent to the remote before a checkpoint is taken. The number of records 
sent equals CKPTLNS times CKPTPGS. The checkpoint is not taken until JES2 
receives acknowledgment that the remote successfully received the data. 

Default: 1 

CLASS=cl...cn: Specifies the output classes, in priority sequence, to be processed 
initially by this punch. You can specify any number of classes (A through Z and 0 
through 9) up to the maximum number of classes specified by the &NUMCLAS 
parameter. 

Default: BK (where B and K are classes assigned to this remote punch). 

DRAIN/START: DRAIN specifies that this punch is to be started by operator 
command. START, which should be specified for System/36, specifies that this 
punch (if it is ready) is to be started automatically when JES2 starts processing. 

Default: START. 


Chapter 7. Defining MSRJE to a BSC Host System 7-17 



FORMS=cccc: Specifies the forms identifier of the forms that are assumed to be 
initially loaded in this punch (1 through 4 alphameric characters). 

Default: JES2 will use the identifier specified by the &STDFORM generation 
parameter. 

LIMIT=(m-n,m-*): The LIMIT subparameter allows you to specify that output is 
to be selected for specific punches based upon the amount of the output (in 
records). The values m and n specify within what output size range (in records) a 
job output element (JOE) must fall to be processed by this punch. The integer m 
specifies the lower output size limit and n specifies the upper output size limit. The 
value of m must be less than the value of n. The maximum value that can be 
explicitly assigned to n is 999999 records. If * is specified, the upper limit is set to 
the default value of n (4294767295). 

Default: m equals 0, and n equals 4294767295. 

NOSEP/SEP NOSEP specifies that separator cards are not to be provided initially 
between data set groups. 

Default: SEP, which specifies that separator cards are to be provided initially 
between data set groups. 

ROUTECDE=nnn: Specifies the route code (1 through 255) to be assigned to this 
punch. The route code specified may be that of any remote terminal defined to 
JES2 by the RMTnnn initialization parameter. 

Default: JES2 assigns the route code of the remote terminal to which the punch is 
attached. (See the description of the RMTnnn parameter in this chapter for more 
information about the route code.) 
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Rnnn.RDm (Remote Card Reader Definition) 


The Rnnn.RDm parameter specifies the characteristics of one logical reader at a 
remote work station. Specify one Rnnn.RDm parameter for each reader at the 
work station. 

nnn specifies the number of a work station as specified in an RMTnnn parameter, 
m specifies the number of this card reader. 

The number of punches defined using the Rnnn.PRm parameter must match the 
number of readers specified for the NUMRD subparameter of the RMTnnn 
parameter. 

The following subparameters further define the remote reader: 

CLASS=c: Specifies the job class to be assigned to all jobs that are entered at this 
card reader and that do not specify a job class in the CLASS operand of their JOB 
statements. The value c can be any class A through Z and 0 through 9. 

Default: A 

DRAIN/START: DRAIN specifies that this card reader is to be started by 
operator command. START, which should be specified for System/36, specifies 
that this card reader is to start automatically when JES2 starts processing. 

Default: START. 

HOLD/NOHOLD: HOLD specifies that all jobs entered at this card reader are to 
be held after JCL conversion until they are released for execution by the operator. 

Default: NOHOLD which specifies that jobs entered at this card reader are to be 
queued as usual. 
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MSGCLASS=c: Specifies the default message class to be assigned to jobs that are 
entered at this card reader and that do not specify a MSGCLASS operand in their 
JOB statements. The value c can be any class A through Z and 0 through 9. 

Default: A 

PRDEST=ium: Specifies the printer destination for the printed output from all 
jobs that are entered at this card reader that do not have a ROUTE statement or 
DEST parameter. 

Default: The route code (ROUTECDE) specified in the RMTnnn parameter for 
this remote terminal. 

PRIOINC=nn: Specifies a number (0 through 15) to be added to the selection 
priority of each job entered at this card reader. 

Default: 0 

PRIOLIM=nn: Specifies the maximum priority level (0 through 15) that can be 
assigned to jobs entered at this card reader. 

Default: 15 

PRLCL/PRRMT: PRLCL specifies that the route code specified by PRDEST is 
that of a local printer. 

Default: PRRMT, which specifies that the route code specified by PRDEST is that 
of a remote printer. 

PUDEST=nnn: Specifies the card punch destination for the punched output from 
jobs entered at this card reader that do not have a ROUTE statement or a DEST 
parameter. 

Default: The route code (ROUTECDE) specified in the RMTnnn parameter for 
this remote terminal. 

PULCL/PURMT: PULCL specifies that the route code specified by PUDEST is 
that of a local card punch. 

Default: PURMT, which specifies that the route code is that of a remote card 
punch. 

In addition to the JES2 parameters, an NCP generation for the 37xx may be 
necessary. For additional information, refer to the NCP generation information in 
this chapter. 


7-20 Multiple Session Remote Job Entry Guide 



JES3 Host System Generation for BSC 


Parameters specified on the following JES3 initialization statements effect JES3 
BSC Remote Job Processing (RJP) execution and operation. For a complete 
description of JES3 generation, see the manual OS/VS 2 MVS System Programming 
Library: JES3. 

CONSOLE (RJP Operators Console) 

Each terminal that requires real or simulated console support should be specified 
with a CONSOLE initialization statement. This statement is used to assign JES3 
destination classes to that console. Only one console can be specified on each 
CONSOLE statement. The following parameters make up the CONSOLE 
statement: 

JNAME=name: Specifies the name of the BSC RJP terminal. This name must 
match the name specified in the N parameter on a RJPTERM statement. 

TYPE=RJP: Specifies that the console being defined is an RJP console. 

DEST=destcode: Specifies one or a series of destination codes that represent 
message classes to be directed to this console. 

The following are values which can be specified for destcode. They represent the 
96 JES3 message categories: 

ALL: Specifies that messages issued by the operator with the destination 
specified as ALL will be routed to all consoles regardless of what is specified in 
the DEST parameter of the CONSOLE statement unless DEST=NONE is 
specified. 

ERR: Console receives messages concerning equipment failure as well as JES3 
failsoft messages. 

JES: Console receives general information messages pertaining to the operation 
of the global processor. 

LOG: Console receives messages concerning active jobs, such \s job started or 
job ended. 

MN: Console receives all input and output messages, except security messages, 
providing that MLOG is specified in the HARDCOPY parameter of the 
CONSTD statement. This is in addition to the original source consoles or 
destination consoles which also receive the messages. 

SEC: Console receives security messages. 

TAP: Console receives messages which apply to the JES3 background utilities 
with JES3-controlled tape requirements, such as tape-to-print or card-to-tape. 

TP: Console receives messages which apply to RJP teleprocessing equipment. 
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UR: Console receives messages which apply to the operation of JES3 controlled 
unit record equipment. 

DALL D1 to D22: Console receives messages that apply to a user defined 
console configuration. Either all of the messages in this group may be selected 
for this console by specifying DALL, or specific classes in the group may be 
selected by specifying one or a subset from D1 through D22. 

MALL Ml to M32: Console receives messages which are unique to an ASP 
main, JES3 local or JES3 global processor. Either all of the messages in this 
group may be selected for this console by specifying MALL, or specific classes 
in the group may be selected by specifying one or a subset from Ml to M32. 

The destination code is associated with a processor by the MDEST parameter in 
the MAINPROC statement. 

SALL SI to S32: Console receives messages which pertain to JES3 device set 
up. Either all of the messages in this group may be selected for this console by 
specifying SALL, or specific classes in the group may be selected by specifying 
one or a subset from SI through S32. Setup messages regarding a specific 
device are associated with this console by indicating the destination code 
selected from this group in the JUNIT or XUNIT parameter on the DEVICE 
statement. 

NONE: Console does not receive any messages. This destination code is not 
correlated to any message class. 

OUTPUT: Console receives messages in all classes except MLG. This 
destination code is not correlated to any message class. 

TOTAL: Console receives messages from all 96 message classes including 
MLG. This destination code is not correlated to any message class. 

DEPTH=nnn: Specifies the maximum number of messages to be maintained in the 
buffers associated with a RJP console. The DEPTH may be from 1 to 255. When 
an RJP console is queued to depth, the queued messages are written to spool. To 
keep track of the status of console buffers, use the *INQUIRY operator command. 

Default: 50 

LL=nnn: Specifies the longest line length to be printed on this console. If the 
actual line to be written exceeds this length, the line is broken at a comma or a 
blank and continued on the next line. 

Default: 120 

LEVEL=nn: Specifies the authority level (0 through 15) for the JES3 console 
authority routine (IATUX18) to check for validity. 

Default: 0 
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DEVICE (Device Definition) 


The DEVICE statement defines those devices used by JES3 and those devices used 
by jobs running under JES3. Each uniquely addressable device (card reader, 
punch, local or remote console, or printer) attached to a global, local, or ASP main 
processor must be specified on a DEVICE statement if the default characteristics 
are not satisfactory. The default characteristics are provided by the RJPTERM 
initialization statement. Refer to the OS/VS2 MVS System Programming Library: 
JES3 manual for the DEVICE statement parameter descriptions. 

RJPLINE (Remote Job Processing Line) 

The RJPLINE statement is necessary to define the characteristics of a single BSC 
line (and it’s respective adapter) which will be used by the JES3 global processor 
for remote job processing. Additionally, this statement may assign a specific RJP 
work station, defined by the N parameter of an RJPTERM statement, to this line. 
One RJPLINE statement is required for every adapter to be accessed by RJP. The 
following parameters make up the RJPLINE statement: 

N=linename: Specifies the name for this line. This name must not be the same as 
the name specified by the n parameter of an RJPWS or RJPTERM initialization 
statement. 

A=adapter: Specifies the 3-character line adapter address associated with this line. 

F=DIAL; F=NTRS: Used to indicate a dial feature for this line (DIAL) and/or 
the absence of a transparency feature for the line (NTRS). If both DIAL and 
NTRS are selected, both F parameters are specified, as F=DIAL and F=NTRS. 

If the prompt Transparency? was responded to with a Y on display 37.0 during 
MSRJE subsystem member configuration at System/36, do not specify F=NTRS. 

Default: Dedicated or leased line environment. Transparency feature assumed on 
terminals on this line. 

G=grpname: Indicates a line group name of up to 8 characters, which associates 
several lines. 

Default: 8 blanks. 

I=B/A: B refers to the second interface of the BSC adapter. A refers to the first 
interface of the BSC adapter. 

Default: A 
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I=Y/N: Y specifies the interrupt mode of operation. N specifies the noninterrupt 
mode of operation. 

Default: Y 

0=AUT0: Indicates the line option to have the RJP line start automatically; the 
♦START operator command is not required. 

Default: *START operator command is required. 

P=password: Provides for password protection for this line. P indicates a line 
password of 1 to 8 alphameric characters. This password must be used by any 
work stations attempting to sign on to this line. 

The value specified for the passwordl parameter in the host SIGNON command on 
display 35.0 during MSRJE subsystem member configuration at System/36 must 
match the value specified here. 

Default: 8 blanks. 

S=linespeed: Indicates a line baud rating up to 6 characters. 

Default: 2400 

T=termname: Indicates a terminal to be assigned to this line. If this parameter is 
included, the /*signon card must not be used. T specifies the name (up to 5 
characters) of a nonprogrammable terminal. This name must also appear in the N 
parameter of an RJPTERM statement and NAME parameter of a CONSOLE 
statement. The T parameter must not be specified when F=DIAL is specified. 
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RJPTERM (BSC Remote Job Processing Terminal) 


The RJPTERM statement defines a single remote BSC work station to the JES3 
system. This statement causes a default description to be provided for each work 
station device (printer, punch, or card reader) indicated by the PR, PU, and RD 
parameters along with the operating characteristics of the work station. If the JES3 
default characteristics for a remote printer or punch are not acceptable, a DEVICE 
statement should be coded to indicate desired characteristics. If a work station is 
to have the facilities of a JES3 operator console, then a CONSOLE statement must 
be coded. 

N=name: Required to indicate the name for this work station. This name must be 
5 characters and cannot be the same as an N parameter specified on an RJPLINE 
or RJPWS statement. 

T=termtype: Specify S360 for System/36 MSRJE. 

B=bufsiz: Indicates the terminal buffer size in bytes. The value specified here 
must match the value specified for the prompt Buffer length on display 11.0 during 
line member configuration at the System/36. 

Default: 400 

C=(R,S): Indicates the type of console support for this work station. If the C 
parameter is specified, a CONSOLE statement should be specified also. 

R: Applies to programmable terminals only. This subparameter indicates 
the presence of a real console. 

S: Applies to both programmable and nonprogrammable terminals. This 
subparameter specifies that regardless of any real console attached to this 
work station, the printer designated as prl is to be used as a simulated 
console output device. 

If S is specified for a programmable terminal that has a real console, that 
console can still be used to enter console commands. However, all console 
output will be directed to the printer. 

Specify C=R for System/36. 

Default: R 

F=NTRS: Specifies that the terminal transparency feature is not present on this 
terminal. If you responded Y (yes) to the prompt Transparency? on display 37.0 
during MSRJE subsystem member configuration at System/36, do not specify 
F=NTRS. 

Default: Transparency is assumed. 

PR=nn: Indicates the number of remote printers associated with this work station. 
The value range for nn is 0 through 7. 
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The value specified here should not be greater than the value entered in response to 
the prompt Maximum number of printers on display 36.0 during subsystem 
configuration at System/36. 

Default: 0 

PRW =recsize: Indicates the maximum print record size for the remote printer. 
Specify 198 only if you are using a forms control table entry with a printwheel ID 
which has a CPI=15, or if you are using a print image of CPI=15 when using a 
printer which supports a CPI=15. Specify 132 if you are not using a printwheel ID 
which has a CPI=15. 

Default: 132 

PU=nn: Indicates the number of remote punches associated with this work station. 
The value range for nn is 0 through 7. 

The value specified here should not be greater than the value entered in response to 
the prompt Maximum number of punches on display 36.0 during subsystem 
configuration at System/36. 

Default: 0 

PUW=recsize: Indicates the maximum punch card record size for the remote 
punch device. 

The value specified here (1 through 4096) should be 80 for System/36. The 
destination of punch and print output received by MSRJE at System/3 6 is 
controlled by a forms control table, as generated using the forms control table 
utility (see Chapter 5 for a description of forms control tables). 

Default: 80 

RD=nn: Indicates the maximum number of readers at this work station. The value 
range for nn is 1 through 7. 

The value specified here should be at least as large as the value entered in response 
to the prompt Maximum number of host readers on display 37.0 during MSRJE 
subsystem member configuration at System/36. 

Default: 0 


7-26 


Multiple Session Remote Job Entry Guide 



P=password: Specifies the 1 through 8 alphameric character password of the 
terminal. The password must be used by any work station trying to sign on to 
JES3. 


If a password is specified, it must match the value specified for the password! 
operand of the DATA parameter for the host signon specified on display 35.0 
during MSRJE subsystem member configuration. 

Default: 8 blanks. 

CS=(Y,B,N): Y indicates that equal character compression only is requested for 
this terminal. B indicates that blank compression only is requested for this 
terminal. N indicates that no compression is requested. 

Specify N for System/36. 
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RES Host System Generation 


The creation of a VS 1 system that supports BSC remote work stations requires two 
steps: 

• A two-stage VS1 system generation with the options required to make the 
RTAM modules available in the VS1 system for the next step. 

• A two-stage RTAM generation. This step assembles the desired RTAM 
facilities and link edits them into the VS1 system. 

For a complete description of RES generation, see the OS/VS1 RES System 
Programmer's Guide . 

VS1 System Generation Requirements 

As part of a complete VS1 system generation, specify OPTIONS=REMOTE in the 
SCHEDULR macroinstruction to condition VS1 for the subsequent generation of 
RTAM. This causes the system to copy the necessary RTAM modules from the 
distribution libraries into the VS 1 system libraries. 

All BSC unit control blocks that describe the BSC line should be generated at this 
time since the communications controller uses those addresses. 

Account Facility modules and RES modules are unconditionally copied during VS1 
generation. 


RTAM Generation 


RTAM generation is a two-stage process that must be performed whenever a new 
VS1 release is installed. 


Stage 1 


Stage 1 is an assembly for which input consists of the following installation coded 
macroinstructions: 

LINE: This is step 1 of stage 1. Specify one LINE macroinstruction for each BSC 
communication line. All LINE macroinstructions must appear first in the macro 
input, and they must be in ascending BSC line number sequence; that is, the first 
LINE macroinstruction must have the number 1, the second, number 2, and so on. 

LINEID=n: Specifies the number of this BSC line. The number must be an 
integer in the range 1 through 200. The LINEID of the first (or only) LINE 
macroinstruction must be 1, and every succeeding LINEID must be 1 greater 
than the LINEID preceding it. 

LDESCR=(type,code): Specifies the type of BSC line and the code to be 
transmitted. 
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For type, specify either of the following values: 

• 0 for half duplex; 1200 through 9600 bits-per-second 

• 1 for duplex; 1200 through 9600 bits-per-second 
For code, specify either of the following: 

• 0 for EBCDIC; no transparency 

• 1 for EBCDIC; transparency 

AUTOLOG=YES/NO: If you want the remote terminal to be automatically 
logged off if this BSC line goes down (intervention is required), specify 
AUTOLOG=YES. After the system restarts the line, you may logon again. If 
you do not want automatic logoff, specify or default to AUTOLOG=NO. The 
work station remains logged on until a LOGOFF command is entered. 

LEASED=YES/NO: Specifies whether the line being defined is switched 
(LEASED=NO) or nonswitched (LEASED=YES). 

TERMINAL: This is a continuation of step 1 of stage 1. You must include the 
TERMINAL macroinstruction to associate an identification number with a work 
station and to specify the terminal device characteristics of the work stations. 
Specify at least one TERMINAL macro for each work station. The first 
TERMINAL macroinstruction must immediately follow the last LINE 
macroinstruction. 

The following parameters define the terminal to RTAM. 

TERMID=termid: Specifies the terminal number for this work station. 

TDESCR=(w,t,d,f): Defines the characteristics of the remote work station. The 
parameters are: 

w maximum print width, specify 3 (132 characters), 

or specify 5 (150 characters) if you are using a forms control table 
entry with CPI=15 or a print image which has a CPI=15 when using 
a printer which supports a CPI of 15 

t terminal type, specify 4 (360/25 and up, including System/370) 
d interface type, specify 4 (programmable interface) 
f console support/transparency, specify 2 (console, no transparency) 
or 3 (console, transparency) 

LNUM=n: Specifies the number of the BSC line with which this work station is 
to be associated. 

RDRS=rd: Specifies the number of readers to be used at this work station. If 
this operand is omitted, one reader is assumed. The range of rd is 1 through 7. 

The value specified here must at least as large as the value specified for the 
prompt Maximum number of host readers on display 37.0 during MSRJE 
subsystem member configuration at System/36. 
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PTRS=pr: Specifies the number of printers at this work station. If this operand 
is omitted, one printer is assumed. The range of pr is 0 through 7. 

The value specified here must not be greater than the value specified for the 
prompt Maximum number of printers on display 36.0 during MSRJE subsystem 
member configuration at System/36. 

PCHS=pu: Specifies whether a punch is at this work station. If this operand is 
omitted, one punch is assumed. The range of pu is 0 through 7. 

The value specified here must not be greater than the value specified for the 
prompt Maximum number of punches on display 36.0 during MSRJE subsystem 
member configuration at System/36. 

CNMSGNO=wtonum: Specifies the maximum number of WTO(R) buffers to 
be available for sending console messages to this work station. 

TIMEOUT=n: Specifies the length of time, in minutes, that RTAM will handle 
timeouts from a work station defined as AUTOLOG=YES. 0 minutes indicates 
infinity. 

CONPR=value: Specifies the printer to be used for console output if console 
support is not specified and more than one printer is specified. The number can 
be from 1 to the number of printers specified. 

Default: CONPR=l. 

RTAM Macro: This is step 2 of stage 1. The RTAM macroinstruction determines 
the internal characteristics of RTAM. 

TPBUF=n: Specifies the number of teleprocessing buffers required for BSC 
work stations. If this operand is omitted, n is assumed to be the same as the 
number of communications lines that have been defined by LINE 
macroinstructions. It is recommended that the following formula be used to 
determine the number of buffers that should be specified: 

n = x + y 

where x is the total number of lines defined for RTAM usage, and y is the total 
number of BSC CPU (central processing unit) work stations defined for RTAM 
usage. System/36 is a BSC CPU work station. 

TPBFSIZ=size: Specifies the size of each telecommunications buffer. The 
value entered here must equal the value entered for the prompt Buffer length on 
display 11.0 during line member configuration at System/36. 

Default: 344 

USASCII=YES/NO: If USASCII code has been specified for a BSC line, 
specify this operand as USASCII=YES; otherwise, the default (NO) applies. 
Specify NO for System/36. 
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TPREAD=readn: Specifies the total number of readers associated with the 
maximum number of work stations that can be logged on at one time. You can 
find this value by adding up the number of readers for all work stations that will 
be logged on at the same time. When a work station logs on, RTAM allocates 
resources for all job input readers (and also printers and punches). Therefore, if 
you specify too small a value for readn, a user might not be able to log on 
because of insufficient resources. 

TPPRINT=printn: Specifies the maximum number of concurrent print 
operations. As recommended for TPREAD, you should specify a value for 
TPPRINT that is at least equal to the total number of printers at work stations 
allowed to log on at one time. You can find this value by adding up the number 
of printers for all work stations that will be logged on at the same time. 
Resources are allocated as discussed for TPREAD. 

TPPUNCH=punchn: Specifies the maximum number of concurrent punch 
operations. As recommended for TPREAD and TPPRINT, you should specify a 
value for TPPUNCH that is at least equal to the total number of punches at 
work stations allowed to log on at one time. You can find this value by adding 
up the number of punches for all work stations that will be logged on at the 
same time. Resources are allocated as discussed for TPREAD. 

MLBFSIZ=size: Specifies the size of the MULTILEAVING buffers, which are 
used by CPU work stations. 

MXINTBR=mxintbr: Specifies the maximum size of any single interface buffer 
pool. It is recommended that you specify a value at least twice as large as 
TPBFSIZ to allow room for compressed records to be expanded. 

With these macroinstructions, you provide the specifications that meet your 
particular requirements, and define the telecommunications network to be 
supported by RTAM (Stage 1). Stage 1 output is the input for stage 2. 


Stage 2 


Stage 2 consists of the execution of the job output from stage 1 including 26 
assemblies and two link edits of the execution-time modules. 
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Example RES Generation 


Date last changed 06/15/81 
SCP level OS/VS 1 - 7A 


PTF level Put - 8106 
Configuration supported 


Line 

Line 

Number 

Speed 

1 

2400 

2 

2400 

Term 

Wrk/Sta 

Number 

Type 

1 

CPU 

2 

CPU 


Line Description for BSC Lines 

LINE LINEID=1, 

LDESCR=(0,1), 

LEASED=N0, 

AUTOLOG=YES 


Line 

Line 

Line 

Type 

Cntl 

Mode 

Swd 

BSC 

HDX/TRANS 

Lsd 

BSC 

HDX/TRANS 

Line 



Cntl -- 


-NOTES- 


BSC CPU work stations (console support) 
BSC CPU work stations (console support) 


BSC line number 

half duplex/1200-9600 baud/trans 

this is a switched line 

force logoff if line goes down 


I 


Interface at half duplex 1200 through 9600 baud depending on the modem. This 
line is generated as switched. The user will be logged off if intervention is required. 


LINE LINEID=2, 

LDESCR=(0,1), 
LEASED=YES, 
AUTOLOG=YES 


BSC line number 

half duplex/1200-9600 baud/trans 

this is a leased line 

force logoff if line goes down 


Interface at half duplex 1200 through 9600 baud depending on the modem. This 
line is generated as a leased (nonswitched) line. The user will be logged off if 
intervention is required. 
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Terminal Description for CPU-Type Work Stations 


TERMINAL TERMID=1, 

TDESCR=(3,4,4,3), 
PTRS=1, 

PCHS=1, 

RDRS=1, 

CNMSGN0=5, 
TIME0UT=2, 

CONPR=1, 

TERMINAL TERMID=2, 

TDESCR=(3,4,4,3), 
PTRS=1, 

PCHS=1, 

RDRS=1, 

CNMSGN0=5, 

CONPR=1, 


Work station terminal number 
Work station attributes 
Number of printers/work stations 
Number of punches/work stations 
Number of readers/work stations 
Number of write to operator buffers 
Restart line after 2 minutes if errors 
Use printer if no console support 
Work station terminal number 
Work station attributes 
Number of printers/work stations 
Number of punches/work stations 
Number of readers/work stations 
Number of write to operator buffers 
Use printer if no console support 


RTAM Description For RES System Generation 


RTAM TPBUF=28, 

TPBFSIZ=512, 
USASCII=NO, 

TPREAD=6, 

TPPRINT=6 r 
TPPUNCH=6, 

MLBFSIZ=512, 
WAITIME=3, 

MXINTBR=1024, 
MSGFCTR=25, 
STBUFNO=48, 
RMTOBJ=SYS1.RTAMOBJ, 
HALFGEN=NO 


Number of BSC teleprocessing buffers 

Size of BSC teleprocessing buffers 

No USASCII for BSC 

Total number of readers 

Total number of printers 

Total number of punches 

CPU work stations buffer size 

Wait time for non-CPU BSC work stations 

Single interface buffer size 

Write to operator increase factor 

Number of subtask buffers 

Object library for RES generation 

No halfgen 
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3705 NCP/PEP Generation 


The generation procedure for preparing a Network Control Program includes: 

• A generation language by which network configuration and program options 
are specified. 

• A library of macrodefinitions from which the specified source statements are 
expanded. 


Generation Language 

The generation language consists of macroinstructions that fall into four categories 
according to the type of parameters they define. The types of macros are: 

• System macros 

• Configuration macros 

• Block handling macros 

• A generation delimiter macro 

System Macros 


The system macros provide information pertaining to hardware features with which 
the communications controller is equipped, certain network control program 
options, and program generation information such as data set names. 

Configuration Macros 

The configuration macros provide the information necessary to construct the 
control tables needed by the network control program. These tables are used to 
control the flow of data between the 3705 and remote stations or other 3705s and 
the host system processor. 

One group of these macros defines the characteristics of these elements in the 
network: 

• Line groups 

• Communications lines 

• Cluster controllers 

• Terminals 

• Components of terminals 
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A macro is coded for each element in the network. The macros must be arranged 
in a specific order to associate a particular communications line with a particular 
line group, a particular station or a particular SNA physical unit. The rest of the 
configuration macros provide the following types of information: 

• Information needed for data transfer between the communications access 
method and the network control program. 

• Information describing the communications scanner(s) installed in the 3705. 

• Definition of the remaining control tables necessary to control the network. 


Block Handling Macros 


The block handling macros apply to messages transmitted over binary synchronous 
communications lines. 


Generation Delimiter Macro 


The generation delimiter macro ends the program generation input stream. 

When the programmer has coded the generation macros that describe the network 
to be controlled, he generates the control program using the generation procedure. 
The procedure is executed as a series of jobs in the host processor. 


Example 3705 PEP Generation 

PEP GENERATION FOR 3705-11 
Date last changed 03/09/82 
NCP level (NCP REL3) 

PTF level PUT - 8201 
Configuration supported 


UCB 

3705 



LINE 

LINE 

TERM 

SUBCHAN 

LINE ADDR 

USE 

SPEED 

CNTL 

NAME 

USAGE 

034 

022 

EP/LSD 

2400 

BSC 

LSBSC1 

RES/RTAM 

046 

0A1 

EP/SW 

2400 

BSC 

SWBSC1 

RES/RTAM 

046 

0A1 

EP/SW 

2400 

BSC 

SWBSC1 

RES/RTAM 
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The following shows an example of what you would write for a nonswitched line. 


LSGRP1 GROUP DIAL=NO, 

LNCTL=BSC, 
BUFSIZE=32 r 
CODE=EBCDIC, 
TADDR=NONE, 
M0DEM=0PTI0N2 , 
FEATURE=(NODUALCD), 
INTPRI=1, 
CHNPRI=NORMAL, 
DATARATE=HIGH, 
QUIET=NO, 
DISABLE=NO, 

PAD=YES, 

TYPE=EP 


Group macrodefinition 

(default) 

(default) 

(default) 

(default) 

(default) 

(default) 

(default) 

(default) 

(default) 

(default) 

(default) 


LSBC1 LINE ADDRESS*(022,34-0), Line macrodefinition 

SPEED=2400 , 

CLOCKING=EXT, 

DUPLEX=HALF , 

TERM=SYS3 , 

CU=2701, 

USE=EP, 
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The following shows an example of what you would write for a switched line. 


SWGRP1 GROUP DIAL=YES, 

LNCTL=BSC, 
CODE=EBCDIC, 
M0DEM=0PTI0N2, 
FEATURE=(NODUALCD) f 
INTPRI=1, 
CHNPRI=NORMAL, 
DATARATE=HIGH, 
RING=NO, 

QUIET=NO, 

DISABLE=NO, 

PAD=YES, 

TYPE=PEP 


Group macrodefinition 

(default) 

(default) 

(default) 

(default) 

(default) 

(default) 

(default) 

(default) 

(default) 

(default) 


SWBSC1 LINE ADDRESS=(0A1,46-0), Line macrodefinition 

SPEED=2400, 

CLOCKING=EXT, 

DUPLEX=HALF, 

TERM=SYS3, 

CU=2701, 

USE=EP, 

RETRIES=(5 f 4 f 3) , 
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RSCS Host System Generation 


There are two different RSCS VM/370 programs for use with remote work 
stations: the RSCS component of VM/370 and the RSCS networking program 
product. The two look the same to the work station; however, the method for 
defining the work station at the host system is different for each. In this section, 
the RSCS component of VM/370 is referred to as RSCS component , and the 
RSCS networking program product is referred to as RSCS networking. 

For complete information on VM/370 RSCS generation, see the IBM Virtual 
Machine Facility/370: System Programmer's Guide. 

Note: Print lines longer than 132 characters are not supported unless you are using a 
forms control table entry which specifies a CPI=15, or a print image which 
has CPI=15 supported when you are using a printer which supports CPI—15. 

Also, Forms Control Block Images are not supported by MSRJE. 

Defining Work Stations to RSCS 

To use a work station with RSCS, the work station’s name must be defined to 
RSCS. To define the name, an entry must be made in either the AXSLINK COPY 
file for RSCS component or in the RSCS directory for RSCS networking. A work 
station can also be dynamically defined. 

AXSLINK COPY File (RSCS Component) 

The AXSLINK COPY file contains a record of all possible paths for transmission 
between the RSCS virtual machine and all the single, uniquely defined, remote 
work stations. 

GENLINK Macro: The GENLINK macro defines the attributes of the link to the 
RSCS virtual machine and is similar to the LINK command in RSCS networking. 

The following parameters of the GENLINK macro define the transmission path. 

ID=linkid: Specifies, in 1 through 8 alphameric characters, the link identifier for 
the work station. 

TYPE=DMTSML: Specifies that the spool MULTILEAVING (SML) line driver 
is to be used on the data link. If DMTSML is not specified, it must be specified 
when the link is activated using the START command. 

Default: Undefined. 

CLASSIC: Specifies the class of files that can be transmitted to the remote work 
station. One to four VM/370 spool classes can be specified and are in the range A 
through Z and 0 through 9. Files are transmitted in class order, left to right. 

Default: *, all classes can be transmitted. 
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KEEP=holdslot: Specifies the number of RSCS virtual machine storage file tag slots 
to be reserved for exclusive use by the link. Specify any decimal number from 0 
through 16. 

Default: 2 

LINE=vaddr: Specifies the RSCS virtual machine device address of a permanent 
telecommunications line port to be used for processing files on the link. 

Default: Undefined. 

TASK=taskname: Specifies a task name for use by the line driver program. From 
one to four alphameric names can be specified. 

Default: Undefined. 

RSCS Directory (RSCS Networking) 

Each work station’s operation must be specified using local (to the host system) 
definitions and options. A directory file with a file name of RSCS and a file type of 
direct is built for the use of RSCS networking. 

The following statements are used to build the entries in the file. Note that RSCS 
networking also generates 16 null entries in the file so that work stations can be 
dynamically defined. 

LINK Control Statement: Defines the attributes of a single RSCS link. Link 
attributes can be later changed using the START command parameters. The 
following parameters of the LINK statement define the link: 

linkid: Specifies, in 1 through 8 alphameric characters, the link identifier for the 
work station. 

DMTSML: Specifies the line driver to be used for communications on the link. 
If DMTSML is not specified, it must be specified in the START command. 

Default: Undefined. 

port: Specifies the RSCS virtual machine device address of a permanent 
telecommunications port to be used for communications on the link being 
defined. Valid RSCS addresses are hexadecimal characters from 02 through 
6FF. If port is not defined, it must be specified on the START command. 

Default: Undefined. 

zone: Specifies the number of time zone boundaries between the work station 
and Greenwich time to the east. The international date line is included as a time 
zone boundary. Valid entries are 0 to 24, decimal. 

Default: 0 

task: Specifies a task name for use by the line driver program. Each RSCS task 
must have a unique name while it is active. One to four task names can be 
specified. 
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Default: The first 4 characters of the linkid. 


class: Specifies the class of files that can be transmitted to the remote work 
station. One to four VM/370 spool classes can be specified and are in the range 
A through Z and 0 through 9. Files are transmitted in class order, left to right. 

Default: *, all classes can be transmitted. 

keep: Specifies the number of RSCS virtual machine storage file tag slots to be 
reserved for exclusive use by the link. Specify any decimal number from 0 to 16. 

Default: 2 

FARM Control Statement: Defines a default parameter string of arbitrary text 
information made available to the line driver when the link is activated by the 
START command. The string specified can be overridden by the Parm operand of 
the START command. 

linkid: Specifies, in 1 through 8 alphameric characters, the identifier of the 
previously defined port on which the work station is connected, and to which the 
parameter string applies. 

Mm: Specifies an identification number assigned to the work station by the 
host. Valid entries are 00 through 99, decimal. The value specified here and the 
value specified for the REMOTEnn parameter of the /*SIGNON on display 
35.0 during MSRJE subsystem member configuration must match. 


Initiating the Connection 


Starting an SML Line Driver (DMTSML) 

Before a work station can sign on to SML, the appropriate task for that link must 
have been started during system start up or by the System/370 RSCS operator. 

The START command is used to start the appropriate task, and has the following 
parameters: 

linkid: Specifies, in 1 through 8 alphameric characters, the link identifier for the 
work station. 

TYPE DMTSML: Specifies the name of the line driver to be used. 

LINE vaddr: Specifies the RSCS virtual machine address of the communications 
line port (specified only if the port to be used is different than the one specified 
for the linkid). 

Parm: A keyword that specifies that one or more parameters as follows: 

Mm: Specifies an identification number assigned to the work station by the 
host. Valid entries are 00 through 99, decimal. The value specified here and 
the value specified for the REMOTEnn parameter of the /*SIGNON on 
display 35.0 during MSRJE subsystem member configuration must match. 
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Bnnim: Specifies the size, in bytes, of each communications buffer. The 
maximum value is 1017. If a password entry is made, this value must be 
specified. The value specified here must match the entry made for the prompt 
Buffer length on display 11.0 during line member configuration at the 
System/36. 

Default: 400 

password: Specifies the 1 through 8 alphameric character password that the 
terminal must send to sign on to the link. If a password is entered here, the 
same entry must be made for the password parameter of the /*SIGNON 
specified on display 35.0 during MSRJE subsystem member configuration at 
System/36. 

Default: No password. 

Note: If a password is specified, you must also specify a value for the Bnnnn 
parameter. 

TASK=name: Specifies a task name for use by the line driver program. One to 
four alphanumeric names can be specified. 

Default: Undefined. 

CLASS=C: Specifies the class of files that can be transmitted to the remote 
work station. One to four VM/370 spool classes can be specified and are in the 
range A through Z and 0 through 9. Files are transmitted in class order, left to 
right. 

Default: The class defined for the link’s link table entry. 

Note: The maximum print length supported is 198. 
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Chapter 8. Defining MSRJE to an SNA Host System 


This chapter contains information that is needed by the host system programmer 
to properly configure a communications network that includes System/3 6 
running MSRJE. The information given here is intended to point out those 
items that are needed to support MSRJE; it is not intended to be a reference 
document for configuring a host system. Changes to the parameters and their 
default values sometimes occur between releases. Therefore, the information 
given here may not exactly reflect the host subsystem release with which you are 
operating. 


System Components 

SNA MSRJE enables the System/36 to submit jobs to an IBM host processor 
using SDLC or X.25 link protocol. The System/36 serves as an RJE work 
station in the network. 

SNA MSRJE supports communications with the following host subsystems using 
Advanced Communications Function/Virtual Telecommunications Access 
Method (ACF/VTAM) Release 2 or 3, and Network Control Program/Virtual 
Storage (NCP/VS) Release 2 or 3: 

• OS/VS2 Job Entry Subsystem 2 (JES2) 

• OS/VS2 Job Entry Subsystem 3 (JES3) 

• OS/VS1 Remote Entry Services (RES) 

. VSE/POWER 

SNA MSRJE requires the following components on the host system: 

• 270x or 37xx Communications Controller and ACF/NCP 

• Advanced Communications Function/Virtual Telecommunications Access 
Method (ACF/VTAM) 

. An operating system (OS/VS1, OS/VS2 (MVS), or DOS/VSE) 


Chapter 8. Defining MSRJE to an SNA Host System 8-1 



The relationship of these components to each other is shown in Figure 8-1. 



MVS 37xx System/36 



Job Entry Subsystem 2 


Job Entry Subsystem 3 


Remote Entry Services 


VSE/POWER 


S7909005-0 


Figure 8-1. MSRJE to SNA Host System Relationships 

For the 4300 system with ICA, VTAME will replace ACF VTAM. 
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Communications Controller and the NCP 


The IBM 3 7xx Communications Controllers provide communications control by 
means of the Network Control Program (NCP). A communications controller 
and it’s NCP support a variety of remote terminals attached to the controller. 

The NCP is generated from a series of user-specified macroinstructions. An 
NCP can be generated to handle lines in either network control mode, or 
emulation mode, or both. An NCP that is generated with both kinds of 
functions is called an NCP with the Partitioned Emulation Programming (PEP) 
extension. 

Remote Terminal Access Method (RTAM), JES2, and JES3 use the facilities of 
the NCP to control lines and devices attached to the controllers, to transmit and 
receive data, and to perform error recovery. Virtual Telecommunications Access 
Methods (VTAM) executes macroinstructions to direct the acquisition, reading, 
writing and checking of data from the terminals to which it is connected. 

Note: If you plan to use an X.25 line in connecting your system to an IBM 37xx 
Communications Controller , you will need the Network Packet Switching 
Interface Program Product . 

For additional information on the Communications Controllers and the NCP, 
see one of the following manuals: 

• Introduction to the IBM 3704 and 3705 Communications Controllers 

• 3725 Model 1 Communication Controller , Introduction 

• 3 725 Model 2 Communication Controller, Introduction 
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Communications Access Methods 


RTAM 


RTAM is a communications access method used by SNA operations. All work 
stations, communications line, and transmission code dependencies are resolved 
by RTAM. 

RTAM is started on a communications line basis rather than on a work station 
basis. To initiate processing, the central operator issues a START RTAM 
command, which, in turn, starts one or more communications lines. Additional 
lines can be started later by entering a MODIFY command specifying lines that 
were previously allocated to RTAM. Any work station compatible with the line 
adapter and data set (for switched lines) attached to the line can establish 
connection with RES through a LOGON procedure that identifies the particular 
work stations or work station user. 


JES2 


The Remote Job Entry (RJE) facility of JES2 allows remote work stations to 
use the Job Entry Subsystem. To initiate processing, the system operator starts 
one or more lines by entering the $S Start command. Any work station 
compatible with the line adapter and data set (for switched lines) attached to the 
line can establish connection with JES2 through a SIGNON procedure that 
identifies the particular work station or work station user. JES2 uses RTAM to 
provide an interface between JES2 and the remote terminal. 


JES3 


JES3 uses RTAM to provide an interface between JES3 and the remote 
terminal. RTAM provides blocking/deblocking, compression/decompression, 
and synchronization with the remote terminal. To initiate processing, the system 
operator enters a *START LINE command. Any work station compatible with 
the line adapter and data set (for switched lines) attached to the line can 
establish connection with JES3 through a SIGNON procedure that identifies the 
work station or work station user. 
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JES2 Host System Generation for SNA MSRJE 


When JES2 is started, a series of initialization parameters are processed to 
determine the configuration options to be used. Initialization parameters that 
are required for MSRJE can be characterized as: (1) system-wide initialization 
values and (2) remote work station definitions. For a complete description of 
the JES2 generation, see the manual OS/VS2 MVS System Programming 
Library: Initialization and Tuning. 


JES2 System-Wide Initialization Parameters 

The following JES2 system-wide initialization parameters are used in defining 
System/36 MSRJE work stations. 

LOGONn: The LOGONn parameter identifies JES2 as an application program 
to VTAM. 

APPLID=cccccccc: Specifies, in 1 through 8 alphameric characters, the name 
that the host has assigned to JES2. If specified the value must match the name 
field of the VTAM APL definition for JES2. 

Default: JES2. 

PASSWORD=cccccccc: Specifies, in 1 through 8 alphameric characters, the 
password presented to VTAM. If specified, the password must match the 
PRTCT parameter of the VTAM APL application definition statement. 

Default: No password. 
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&MAXSESS (Maximum Number of VTAM Sessions): The &MAXSESS 
parameter specifies the maximum number of VTAM sessions (nnnn) that can be 
active at any one time. The valid range of values is between 1 and 9999. 
Terminals attempting to log on when nnnn sessions are already active are not 
allowed to log on. 

Default: The number of LINEnnn initialization statements specifying the 
UNIT=SNA keyword. 

&NUMBUF (JES2 I/O Buffer Count): The &NUMBUF parameter specifies the 
number (15 through 2000) of I/O buffers to be included in the JES2 load 
module. The value specified should reflect the total number of buffers required 
for proper operation of JES2. 

Because all JES2 buffers are maintained in a dynamic pool until required by an 
active function, the appropriate number of buffers should be based on the 
predicted number of concurrent functions required at the installation. Refer to 
the OS /VS2 MVS System Programming Library: Initialization and Tuning for 
more information. 

&NUMCMBS (Number of JES2 Console Message Buffers): The &NUMCMBS 
parameter specifies the number (3 through 999) of console message buffers to 
be provided for JES2. The number of buffers specified should be sufficient to 
accommodate all outstanding operator requests and still allow message 
processing to continue. 

During periods of high console activity, when no message buffers are available, 
certain noncritical JES2 messages are discarded to avoid delaying the associated 
process. These noncritical messages include certain RJE-oriented messages, and 
certain 1/O error messages on JES2-controlled devices. 

Default: 15 
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&NUMJOES=nimn (Number of Job Output Elements): Specifies the number of 
job output elements to be generated. 

One job output element is required for each: 

• Unique SYSOUT class that appears in a job that is queued for output. 

• Active printer or punch. 

• Interrupted or restarted job that is not currently active on printer or punch. 

• Unique combination of forms ID, USCID, and FCB ID for all jobs currently 
queued for output. 

• Job that was interrupted by a system failure while being printed or punched 
and has not yet been warm started on an output device. 

Specifying too small a value results in jobs waiting for in-storage queuing before 
completing active print or punch work. For performance, you should specify a 
number slightly greater than the total of the above elements. 

Default: 10 times the total number of local and remote printers and punches. 

&NUMLNES (Number of Teleprocessing Lines): Specifies the maximum number 
of LINEnnn initialization parameters that can be specified. This value includes 
the number of lines defined either as BSC MULTILEAVING lines or as logical 
lines for SNA. 

Default: 0 

&NUMRJE=nnn (Number of Remote Terminal Definitions): Specifies the 
number (0 through 255) of remote terminal definitions (RMTnnn). This value 
should correspond to the highest number used as an RMTnnn initialization 
parameter. 

Default: The value specified for the &NUMLNES parameter. 

&NUMTPBF=nnnn (Number of JES2 Teleprocessing Buffers): Specifies the 
number (0 through 2000) of teleprocessing buffers to be generated for RJE and 
NJE (network job entry) by JES2. This value includes the buffers required for 
remote terminals supported as logical units. 

The minimum requirement for SNA is three buffers plus two buffers for every 
SNA RJE terminal. All other signed-on terminals require at least one buffer 
each. 

Default: 2 times the value of &NUMLNES. 
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&PRTRANS=YES/NO (Print Line Translation Option): Specifies whether to 
translate lines of print not directed to 3211 printers. If the default value is used, 
each line to be printed by a local 1403 or any remote printer is first translated. 
Translation changes: 

• Lowercase letters to uppercase 

• Characters that are invalid on a part-numbered train to blanks. If any print 
train is to be used on a JES2-controlled local 1403 or on a remote printer 
that has characters not equivalent to those on a part-numbered train, NO 
must be specified. 

Default: YES. 

&SPOLMSG=nnn (Remote Terminal Spool Message Record Count): Specifies 
the number (0 through 254) of physical records to be reserved for operator 
messages and JES2 messages for each JES2 remote terminal. 

Default: (4096/&BUFSIZE) x 6 if &NUMLINES is not 0; 0 if &NUMLNES is 

0 . 

&TPBFSIZ=nnnn (Teleprocessing Buffer Size): Specifies the largest 
telecommunications buffer size in bytes (128 through 3976) required for any 
remote work station. 

This value is increased, if necessary, to the largest BUFSIZE value specified for 
an SNA remote terminal. 

Default: 400 

&TPIDCT=nnn (Remote Printer Separator Page Line Count): Specifies the 
number (0 through 255) of print lines that are to appear on each JES2 job 
output separator page for remote terminal printers. If the specification is 30 or 
greater, the first 29 lines are used to produce a block-lettered job name, job 
number, and SYSOUT class. 

Default: 6 

&WAITIME=nn (Remote Terminal Function Interval): Specifies the length of 
time in seconds (1 through 30) JES2 waits after processing an input stream or 
output stream to allow entry of commands or jobs by the RJE operator. 

Default: 1 
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Remote Work Station Definitions 


JES2 remote work station definitions consist of a series of LINEnnn, RMTnnn, 
Rnnn.PRm, Rnnn.PUm, and Rnnn.RDm parameters. The following are used in 
defining System/36 MSRJE work stations: 


LINEnnn (Line Definition) 


The LINEnnn parameter specifies the characteristics of one teleprocessing line 
or logical line to be used during remote job entry. This parameter should be 
specified for each teleprocessing line. Lines are numbered consecutively 
(LINE1 to LINE255) for the number of lines specified by the &NUMLNES 
parameter. 

The following LINEnnn subparameters are used in defining SNA work stations. 

PASSWORD =cccccccc: Specifies a 1 through 8 alphameric character security 
password to be used by this work station when it logs on. 

The entry made here must match the entry made for the passwordl entry of the 
DATA parameter for the host signon specified on display 35.0 during MSRJE 
subsystem member configuration at System/36. 

Default: 8 blanks. 

UNIT=SNA: Specifies that this LINEnnn parameter is for SNA use. 

RMTnnn (Remote Work Station Definition) 

The RMTnnn parameter specifies the characteristics of one remote work station. 
One RMTnnn parameter is required for each work station. 

nnn specifies an identification number for the work station. Work stations are 
numbered consecutively from 1 through 255. Do not use leading 0’s for nnn. 
The highest value specified for nnn must match the value specified for 
&NUMRJE. 

The following subparameters of RMTnnn are used in defining SNA work 
stations. 

LUTYPE1: Must be specified for System/36 MSRJE. 

BUFSIZE=mm: Specify 256. This is the largest request unit (RU) that can be 
sent to or received from this work station. 

Default: 256 

COMP/NOCOMP: COMP specifies that this terminal has the 
compression/expansion feature. All SNA terminals have this feature; but the 
default value, NOCOMP, can be used. 

Default: NOCOMP, which specifies that this terminal does not have the 
compression/expansion feature. 
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CONSOLE/NOCON: CONSOLE specifies that this SNA remote terminal has 
an operator console. Specify CONSOLE for System/36. 

Default: NOCON, which specifies that the remote terminal has no operator 
console. 

CMPCT/NOCMPCT: Specifies whether compaction is used at this work 
station. Specify NOCMPCT since System/36 does not support compaction. 

Default: NOCMPCT. 

DISCINTV=nnnn: Specifies the time interval (in seconds) after which JES2 
terminates the session if there is no text transmission in either direction. 
DISCINTV applies to both switched and nonswitched lines. It is recommended 
that 0 be specified (default) for nonswitched lines. This value indicates that the 
session is not to be terminated and the work station is not to be disconnected. 

Default: 0 

FIXED/VARIABLE: Specify VARIABLE (specifies variable-length data 
records). 

Default: VARIABLE. 

LUNAME=cccccccc: Specifies the logical unit name of this remote work 
station. LUNAME is not required and is used only in conjunction with 
automatic logon. 

If specified, this name must be the same as the name defined to VTAM at 
system initialization. 
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NUMPR=n: Specifies the number of printers at this remote terminal. Valid 
entries are 0 through 7. The maximum value is 6 if CONSOLE is specified, or 7 
if CONSOLE is not specified. 

The value specified here should not be greater than the value specified for the 
prompt Maximum number of printers on display 36.0 during MSRJE subsystem 
member configuration at System/36. 

Note: The total number of printers and punches must not exceed 8. 

Default: 1 

NUMPU=n: Specifies the number of punch devices at this remote terminal. 
Valid entries are 0 through 7. 

The value specified here should not be greater than the value specified for the 
prompt Maximum number of punches on display 36.0 during MSRJE subsystem 
member configuration at System/36. 

Note: The total number of printers and punches must not exceed 8. 

Default: 0 

NUMRD=n: Specifies the number or readers at this remote terminal. Valid 
entries are 0 through 7. 

The value specified here should be at least as large as the value specified for the 
prompt Maximum number of host readers on display 37.0 during MSRJE 
subsystem member configuration at System/36. 

Default: 1 

PASSWORD=cccccccc: Specifies a security password (1 through 9 alphameric 
characters) to prevent unauthorized terminals from using this remote terminars 
resources. 

The entry made here must match the entry made for the password2 operand of 
the DATA parameter for the host signon specified on display 35.0 during 
MSRJE subsystem member configuration at System/36. 

Default: No password. 

ROUTECDE=nnn: Specifies the route code to be assigned to this terminal and 
its associated printers, punches, and readers. The value of nnn may be any 
number from 1 through the value of &NUMRJE. 

Default: If a route code is not specified, JES2 assigns the number of this 
terminal (RMTnnn) as its route code. 
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SETUPHDR/SETUPMSG: SETUPHDR specifies that a function management 
header, containing setup information, is constructed and sent to the remote work 
station. The remote work station is responsible for processing the header and 
generating any required messages. SETUPHDR allows spooling of data and 
generation of multiple copies of a data set (from the original sent by JES2) at a 
remote work station. 

Specify SETUPHDR for the System/36. 

Default: SETUPMSG, which specifies that JES2 is to inform the remote 
operator of any setup requirements via the $HASP190 message. Upon 
completion of setup, the operator must issue a $S command to start JES2 
transmission. 

SETUPINF/SETUPACT: SETUPINF, which should be specified for 
System/36, specifies that operator setup messages issued at the local (CPU) 
console for this remote device are to be informational messages (they do not 
require an operator action to be deleted from a display console). 

Default: SETUP ACT, which specifies that operator setup messages issued at 
the local console for this remote device are flagged as action messages (requiring 
an operator action to be deleted from a display console). 

WAITIME=nn: Specifies the length of time in seconds (1 through 30) that 
RTAM should wait at the completion of the processing of any input stream, 
printed output stream, or punched output stream to allow the operator to enter 
an input stream at this remote terminal. The value of n is greater than 0. 

Default: The value specified for the &WAITIME initialization parameter. 
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Rnnn.PRm (Remote Printer Definition) 


The Rnnn.PRm parameter specifies the characteristics of one printer at a remote 
work station. 

nnn specifies the number of the work station as specified in an RMTnnn 
initialization parameter. 

m specifies the number of this printer. 

The number of printers defined using the Rnnn.PRm parameter must match the 
number of printers specified for the NUMPR subparameter of the RMTnnn 
parameter. 

The following subparameters further define the remote work station printer: 

AUTO/OPERATOR: AUTO specifies that this printer is to operate initially in 
automatic (demand) forms mode when JES2 starts processing. 

Specify AUTO for System/36. 

Default: OPERATOR which specifies that this printer is to operate initially in 
operator-controlled (forms) mode. 

The mode may be modified from the remote terminal via the JES2 $T set 
command. 

CCTL/NOCCTL: CCTL specifies that carriage control characters and SNA 
character strings (SCS) are to be placed in the output stream transmitted to this 
printer. 

Default: CCTL. 
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CKPTLNS=nimmi: Specifies the maximum number of lines (0 through 32767) 
in a page. The size of a logical page is also defined as the number of lines 
printed until: 

• A channel skip is encountered. 

• The line count specified by &LINECT, the /*JOBPARM control statement, 
or the JOB statement accounting field has been exceeded. 

If CKPTLNS is 0, a logical page is defined only by the preceding items. 

If the line count does not equal 0, setting CKPTLNS to a value greater than line 
count results in the line count being used as the definition of a logical page; it 
overrides CKPTLNS. 

CKPTLNS used in conjunction with CKPTPGS is used to specify the 
checkpoint interval for data sets having a line count of 0 and no channel skips. 
In most cases, specifying CKPTLNS=0 sets the most efficient checkpoint 
interval. 

Default: 0 

CKPTPGS==imnim: Specifies the number of logical pages (1 through 32767) to 
be printed before each checkpoint is taken. 

For SNA remote printers, the CKPTPGS and CKPTLNS parameters determine 
the number of logical records within an SNA chain. JES2 will not take a 
checkpoint until it receives acknowledgment that the chain was received 
successfully by the remote. The chain size is the number of logical pages 
specified by CKPTPGS. 

The larger the number you specify for this parameter, the less frequently the 
host system waits for an acknowledgment. Therefore, a larger number may 
improve performance. 

Default: I 

CLASS=cl...cn: Specifies the output classes, in priority sequence, to be 
processed initially by this printer. You can specify any number of classes (A 
through Z and 0 through 9) up to the maximum number of classes specified by 
the &NUMCLAS parameter. 

Default: AJ (where A and J are classes assigned to this printer). 

CMPCT/NOCMPCT: Specifies whether or not this printer has compaction 
capabilities. 

Default: The CMPCT/NOCMPCT specification for the corresponding 
RMTnnn initialization parameter. 

Note: System/36 does not support compaction. 
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COMP/NOCOMP: COMP specifies this remote SNA printer has 
compression/expansion capabilities. COMP forces this remote SNA printer to 
use compression only if the corresponding remote terminal (RMTnnn) 
initialization parameter has COMP specified. NOCOMP turns off compression 
for this remote SNA printer even if the corresponding RMTnnn initialization 
parameter specifies COMP. 

Default: The COMP/NOCOMP specification for the corresponding RMTnnn 
initialization parameter. 

COMPACT=nn/0: Specifies the compaction table (nn) to be used for all 
remote printer data. The CMPCT subparameter of RMTnnn must indicate that 
compaction is supported by this printer. The value range of nn is 0 through 99. 
Specify 0 since System/3 6 does not support compaction. 

Default: 0 (no compaction table). 

DRAIN/START: DRAIN specifies that this printer is to be started by operator 
command. START, which should be specified for System/36, specifies that this 
printer (if it is ready) is to be started automatically when JES2 starts processing. 

Default: START. 

FORMS=cccc: Specifies the forms identifier of the forms that are assumed to 
be initially loaded in this printer (1 through 4 alphameric characters). 

Default: If no value is specified, JES2 uses the forms identifier specified by the 
&STDFORM generation parameter. 

LRECL=nnn: Specifies the logical record length (nnn) of data transmitted to 
the SNA remote printer. This value must not exceed the printer width specified 
during RMT generation (by the &PRTSIZE or PRTFOTLW RMT generation 
parameters) for this terminal. LRECL may be used in place of the PR WIDTH 
subparameter when specifying record sizes destined for remote devices. The 
maximum value for LRECL is 255. 

Specify 198 only if you are using a forms control table entry with a printwheel 
ID which has a CPI=15, or if you are using a print image of CPI=15 when using 
a printer which supports a CPI=15. Specify 132 if you are not using a 
printwheel ID which has a CPI=15. 

Default: 120 

LIMIT=(m-n,m-*): The LIMIT subparameter allows you to specify that output 
is to be selected for specific printers based upon the amount of the output (in 
records). The values m and n specify within what output size range (in records) 
a job output element (JOE) must fall to be processed by this printer. The integer 
m specifies the lower output size limit, and n specifies the upper output size 
limit. The value of m must be less than the value of n. The maximum value that 
can be explicitly assigned to n is 999999 records. If * is specified, the upper 
limit is set to the default value of n (4294767295). 

Default: m equals 0, and n equals 4294767295. 
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NOSEP/SEP: NOSEP specifies that separator pages are not to be provided 
initially between data set groups. 

Default: SEP, which specifies that separator pages are to be provided initially 
between data set groups. 

Note: If 0 print lines were specified by the &TPIDCTparameter, separator pages 
will not be produced even if SEP is specified. 

PR WIDTH= nnn : Specifies the maximum number of characters to be printed on 
one line. 

Specify 198 only if you are using a forms control table entry with a printwheel 
ID which has a CPI=15, or if you are using a print image of CPI=15 when using 
a printer which supports a CPI= 15. Specify 132 if you are not using a 
printwheel ID which has a CPI=15. 

Default: 120 

ROUTECDE=nmi: Specifies the route code (1 through 255) to be assigned to 
this printer. The route code specified may be that of any remote terminal 
defined to JES2 by means of the RMTnnn initialization parameter. 

Default: JES2 assigns the route code of the remote terminal to which the printer 
is attached. (See the description of the RMTnnn parameter in this chapter for 
more information about the route code). 
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Rnnn.PUm (Remote Card Punch Definition) 


The Rnnn.PUm parameter specifies the characteristics of one punch at a remote 
work station. 

nnn specifies the number of the work station as specified in an RMTnnn 
initialization parameter. 

m specifies the number of this punch. 

The number of punches defined using the Rnnn.PRm parameter must match the 
number of punches specified for the NUMPU subparameter of the RMTnnn 
parameter. 

The following subparameters further define the remote work station card punch. 

AUTO/OPERATOR: AUTO, which should be specified for System/36, 
specifies that this punch is to operate initially in automatic (demand) forms 
mode when JES2 starts processing. 

Default: OPERATOR, which specifies that this punch is to operate initially in 
operator-controlled (forms) mode. The mode may be modified from the remote 
terminal via the JES2 $T set command. 

CCTL/NOCCTL: CCTL specifies that card separator control characters are to 
be placed in the output stream transmitted to this punch. 

Default: CCTL. 

CKPTLNS=nnnnn: Specifies the maximum number of cards (0 through 32767) 
to be punched per logical page. 

CKPTLNS is the only value used to define a logical page for punches. 

Default: 100 

CKPTPGS=nnnnn: Specifies the number of logical pages (1 through 32767) to 
be punched before each checkpoint is taken. 

For SNA remote punches, the CKPTPGS and CKPTLNS parameters determine 
the number of logical records within an SNA chain. The number of logical 
records equals CKPTLNS multiplied by CHKTPGS. JES2 will not take a 
checkpoint until it receives acknowledgment that the chain was successfully 
received by the remote. The chain size is the number of logical pages specified 
by CKPTPGS. 

Default: 1 

CLASS=cl...cn: Specifies the output classes, in priority sequence, to be 
processed initially by this punch. You can specify any number of classes (A 
through Z and 0 through 9) up to the maximum number of classes specified by 
the &NUMCLAS parameter. 

Default: BK (where B and K are classes assigned to this remote punch). 
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CMPCT/NOCMPCT: Specifies whether this punch has compaction 
capabilities. Specify NOCMPCT since System/36 does not support compaction. 

Default: The CMPCT/NOCMPCT selection made for the RMTnnn parameter. 

COMP/NOCOMP: COMP specifies that this remote punch has 
compression/expansion capabilities. COMP forces the remote punch to use 
compression only if the corresponding remote terminal (RMTnnn) initialization 
parameter has COMP specified. NOCOMP turns off compression for this 
remote punch even if the corresponding RMTnnn initialization parameter 
specifies COMP. 

Default: The COMP/NOCOMP specification for the corresponding RMTnnn 
initialization parameter. 

COMPACT=nn/0: Specify 0 since System/36 does not support compaction. 
Default: 0 (no compaction table). 

DRAIN/START: DRAIN specifies that this punch is to be started by operator 
command. START, which should be specified for System/36, specifies that this 
punch (if it is ready) is to be started automatically when JES2 starts processing. 

Default: START. 

FORMS=cccc: Specifies the forms identifier of the cards that are assumed to 
be initially loaded in this punch. If SETUPHDR is specified, then FORMS has 
no effect. If SETUPMSG is specified, then JES2 assumes that the cards 
specified are initially loaded in the punch and does not issue a message to the 
operator to load them. 

Default: JES2 will use the identifier specified by the &STDFORM parameter. 

LIMIT=(m-n,m-*): The LIMIT subparameter allows you to specify that output 
is to be selected for specific punches based upon the amount of the output (in 
records). The values m and n specify within what output size (in records) a job 
output element (JOE) must fall to be processed by this punch. The integer m 
specifies the lower output size limit and n specifies the upper output size limit. 
The value of m must be less than the value of n. The maximum value that can 
be explicitly assigned to n is 999999 records. If * is specified, the upper limit is 
set to the default value of n (4294767295). 

Default: m equals 0, and n equals 4294767295. 
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LRECL=NNN: Specifies the logical record length of data transmitted to the 
SNA remote punch. For System/36, specify 80. 

Default: 80 

NOSEP/SEP: NOSEP specifies that separator cards are not to be provided 
initially between data set groups. 

Default: SEP, which specifies that separator cards are to be provided initially 
between data set groups. 

ROUTECDE=nnn: Specifies the route code (1 through 255) to be assigned to 
this punch. The route code specified may be that of any remote terminal defined 
to JES2 by means of the RMTnnn initialization parameter. 

Default: JES2 assigns the route code of the remote terminal to which the punch 
is attached. (See the description of the RMTnnn parameter in this chapter for 
more information about the route code.) 
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Rmm.RDm (Remote Card Reader Definition) 


The Rnnn.RDm parameter specifies the characteristics of one logical reader at a 
remote work station. Specify one Rnnn.RDm parameter for each reader at the 
work station. 

nnn specifies the number of a work station as specified in an RMTnnn 
parameter. 

m specifies the number of this card reader. 

The number of readers defined using the Rnnn.PRm parameter must match the 
number of readers specified for the NUMRD subparameter of the RMTnnn 
parameter. 

The following subparameters further define the remote reader: 

CLASS=c: Specifies the job class to be assigned to all jobs that are entered at 
this card reader and that do not specify a job class in the CLASS operand of 
their JOB statements. The value c can be any class A through Z and 0 
through 9. 

Default: A 

DRAIN/START: DRAIN specifies that this card reader is to be started by 
operator command. START, which should be specified for the System/36, 
specifies that this card reader is to start automatically when JES2 starts 
processing. 

Default: START. 

HOLD/NOHOLD: HOLD specifies that all jobs entered at this card reader are 
to be held after JCL conversion until they are released for execution by the 
operator. 

Default: NOHOLD which specifies that jobs entered at this card reader are to 
be queued as usual. 

MSGCLASS=c: Specifies the default message class to be assigned to jobs that 
are entered at this card reader and that do not specify a MSGCLASS operand in 
their JOB statements. The value of c can be any class A through Z and 0 
through 9. 

Default: A 
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PRDEST=nnn: Specifies the printer destination for the printed output from all 
jobs that are entered at this card reader that do not have a ROUTE statement or 
DEST parameter. 

Default: The route code (ROUTECDE) specified in the RMTnnn parameter for 
this remote terminal. 

PRI01NC=nn: Specifies a number (0 through 15) to be added to the selection 
priority of each job entered at this card reader. 

Default: 0 

PRIOLIM=nn: Specifies the maximum priority level (0 through 15) that can be 
assigned to jobs entered at this card reader. 

Default: 15 

PRLCL/PRRMT: PRLCL specifies that the route code specified by PRDEST is 
that of a local printer. 

Default: PRRMT, which specifies that the route code specified by PRDEST is 
that of a remote printer. 

PUDEST=nnn: Specifies the card punch destination for the punched output 
from jobs entered at this card reader that do not have a ROUTE statement or a 
DEST parameter. 

Default: The route code (ROUTECDE) specified in the RMTnnn parameter for 
this remote terminal. 

PULCL/PURMT: PULCL specifies that the route code specified by PUDEST 
is that of a local card punch. 

Default: PURMT, which specifies that the route code is that of a remote card 
punch. 

In addition to the JES2 parameters, an NCP generation for the 37xx may be 
necessary. For additional information, refer to the NCP generation information 
in this chapter. 
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JES3 Host System Generation 


The following JES3 initialization statement parameters are used in defining 
System/36 MSRJE work stations. For a complete description of the 
initialization parameters, see the manual OS /VS 2 MVS System Programming 
Library: JESS. 

COMMDEFN (Communications Subsystem Interface Definition Records) 

The COMMDEFN statement identifies the optional user communications 
subsystem interface (VTAM) parameters. 

APPLID=applname : Indicates the application name as specified to VTAM in a 
VTAM generation application definition statement (APPL). This parameter is 
used in establishing the application program interface (API) at OPEN ACB 
time. 

Default: JES3 

P=password: Specifies the 1 through 8 character alphameric password which is 
used by JES3 when issuing an OPEN ACB macro. This parameter must be the 
same as the password specified in the PRTCT parameter of the VTAM APPL 
application definition statement. 

Default: No password. 

LU=nnnn: Specifies the total number of LU-to-LU sessions that can exist 
concurrently. 


COMPACT (Compaction Table Definition) 

The compact statement defines a compaction table to JES3. System/36 does 
not support compaction. 

CONSOLE (RJP Operator Console) 

The CONSOLE statement is required to define each SNA RJP console. This 
statement is used to assign JES3 destination classes to that console. Only one 
console can be specified on each CONSOLE statement. The parameters that 
make up the CONSOLE statement are: 

JNAME=name: Specifies the name of the SNA RJP work station. The JNAME 
must match the name specified in the N parameter on a RJPWS statement. 

TYPE=RJP: Specifies that the console being defined is an RJP console. 

DEST=destcode: Specifies one or a series of destination codes that represent 
message classes to be directed to this console. 

The following are values which may be specified for destcode. They represent 
the 96 JES3 message categories: 
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ALL: Specifies that messages issued by the operator with the destination 
specified as ALL will be routed to all consoles regardless of what is specified in 
the DES^ parameter of the CONSOLE statement unless DEST=NONE is 
specified. 

ERR: Console receives messages concerning equipment failure as well as JES3 
failsoft messages. 

JES: Console receives general information messages pertaining to the operation 
of the global processor. 

LOG: Console receives messages concerning active jobs, such as job started or 
job ended. 

MN: Console receives all input and output messages, except security messages, 
providing that MLOG is specified in the HARDCOPY parameter of the 
CONSTD statement. This is in addition to the original source consoles or 
destination consoles which also receive the messages. 

SEC: Console receives security messages. 

TAP: Console receives messages which apply to the JES3 background utilities 
with JES3-controlled tape requirements, such as tape-to-print or card-to-tape. 

TP: Console receives messages which apply to RJP teleprocessing equipment. 

UR: Console receives messages which apply to the operation of JES3-controlled 
unit record equipment. 

ALL D1 to D22: Console receives messages which apply to a user-defined 
console configuration. Either all of the messages in this group may be selected 
for this console by specifying DALL, or specific classes in the group may be 
selected by specifying one or a subset from D1 through D22. 

MALL Ml to M32: Console receives messages which are unique to an ASP 
main, JES3 local or JES3 global processor. Either all of the messages in this 
group may be selected for this console by specifying MALL, or specific classes 
in the group may be selected by specifying one or a subset from Ml to M32. 

The destination code is associated with a processor by the MDEST parameter in 
the MAINPROC statement. 

SALL SI to S32: Console receives messages which pertain to JES3 device 
setup. Either all of the messages in this group may be selected for this console 
by specifying SALL, or specific classes in the group may be selected by 
specifying one or a subset from SI through S32. Setup messages regarding a 
specific device are associated with this console by indicating the destination code 
selected from this group in the JUNIT or XUNIT parameter on the DEVICE 
statement. 

NONE: Console does not receive any messages. This destination code is not 
correlated to any message class. 

OUTPUT: Console receives messages in all classes except MLG. This 
destination code is not correlated to any message class. 
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TOTAL: Console receives messages from all 96 message classes including 
MLG. This destination code is not correlated to any message class. 

DEPTH=nn: Specifies the maximum number of messages to be maintained in 
the buffers associated with a RJP console. The DEPTH may be from 1 through 
255. When an RJP console is queued to depth, the queued messages are written 
to spool. To keep track of the status of console buffers, use the *INQUIRY 
operator command. 

Default: 50 

LL=ium: Specifies the longest line length to be printed on this console. If the 
actual line to be written exceeds this length, the line is broken at a comma or a 
blank and continued on the next line. 

Specify 198 only if you are using a forms control table entry with a printwheel 
ID which has a CPI= 15, or if you are using a print image of CPI= 15 when using 
a printer which supports a CPI= 15. Specify 132 if you are not using a 
printwheel ID which has a CPI=15. 

Default: 120 

LEVEL=nn: Specifies the authority level (0 through 15) for the JES3 console 
authority routine (IATUX18) to check for validity. 

Default: 0 

DEVICE (Device Definition) 

The DEVICE statement defines those devices used by JES3 and those devices 
used by jobs running under JES3. Each uniquely addressable device (card 
reader, punch, local or remote console, or printer) attached to a global, local, or 
ASP main processor must be specified on a DEVICE statement if the default 
characteristics are not satisfactory. The default characteristics are provided by 
the RJPTERM initialization statement. Refer to the OS/VS2 MVS System 
Programming Library: JES3 manual for the DEVICE statement parameter 
descriptions. 


RJPWS (SNA Work Station Definition) 

The RJPWS statement describes a single SNA work station’s characteristics to 
the JES3 system. This statement causes a default description to be provided for 
each work station device (printer, punch, or card reader) indicated by the PR, 
PU, or RD parameter along with the operating characteristics of the work 
station. If the JES3 default characteristics for a remote printer or punch device 
are not acceptable, a DEVICE statement should be coded to indicate desired 
characteristics. 

The SNA work station definition is made up of the following parameters. 

N=name: Specifies the 5-character name of the work station. This parameter 
cannot specify the same name specified in the N parameter on an RJPLINE or 
RJPTERM statement. 
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The value specified here must be the same as the value specified for the wsname 
operand of the DATA parameter in the host signon specified on display 35.0 
during MSRJE subsystem member configuration at System/36. 

RD=nn: Specifies the maximum number host readers. This number must be an 
integer from 0 through 15. 

The value specified here should not be greater than the value specified for the 
prompt Maximum number of host readers on display 37.0 during MSRJE 
subsystem member configuration at System/36. 

Default: 1 

PR=nn: Specifies the maximum number of printers. This number must be an 
integer between 0 and 15. 

The value specified here should not be greater than the value specified for the 
prompt Maximum number of printers on display 36.0 during MSRJE subsystem 
member configuration at System/36. 

Default: 1 

PU=nn: Specifies the maximum number of punches. This number must be an 
integer from 0 through 15. 

The value specified here should not be greater than the value specified for the 
prompt Maximum number of punches on display 36,0 during MSRJE subsystem 
member configuration at System/36. 

Default: 0 

C=(S,R): Specifies the type of console support for the work station. S indicates 
that console and print media share the same presentation services. JES3 never 
interrupts data streams to send console messages. R indicates that the console 
and printer are separate real devices. JES3 interrupts data streams to send 
console messages. Specify R for System/36 MSRJE. 

Default: R 

G=grpname: This parameter associates the work station with a group name. The 
grpname specified can be up to 8 characters long. This name is also the default 
destination for any output data set from a job submitted from a work station in 
the group. 

Default: The name specified in the N parameter on this statement. 

COMPACT=NO/comptbl: Specifies the name of the default compaction table. 
System/36 does not support compaction. Specify NO. 

Default: NO. 
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P=password: Specifies the 1 through 8 alphameric character password to be used 
by the work station. This password must be included in the user data specified on 
the LOGON command passed to the JES3 LOGON exit by VTAM, or JES3 will 
not accept the logon. 

The value specified here must match the value specified for the password operand 
of the DATA parameter for the host logon on display 35.0 during MSRJE 
subsystem member configuration at System/36. 

PL=n: Specifies the number of invalid logons that can be attempted before the 
work station is rejected. 

Default: 2 

AUTO=(Y,N): Specifies whether automatic logon is supported for the work 
station. 

Default: N 

LU=luname: Specifies the LU names associated with this work station as defined 
to VTAM. The names specified are those LUs that are permitted to logon at this 
work station. 

Default: Logons are accepted from any work station. 

Note: If multiple locations are configured for a single line member definition (using 
CNFIGICF on the System/36), then all LU names that correspond to 
MSRJE sessions defined in the System/36 line member should be defined 
here. This will allow any location to use any LU. 

SYSOUT (SYSOUT Class Characteristics) 

The SYSOUT initialization statement is required for each JES3 output class that 
requires other than TYPE=PRINT processing. Refer the OS/VS2 MVS System 
Programming Library: JES3 manual for an explanation of the SYSOUT 
parameters. 


8-26 Multiple Session Remote Job Entry Guide 



RES Host System Generation 

The creation of a VS 1 system that supports SNA remote work stations requires 
three steps: 

1. A two-stage VS1 system generation with the options required to make the 
RTAM modules available in the VS1 system, and to include the system code 
needed to use RTAM. The VS1 system generation must also specify the 
options required to include VTAM in the system. 

2. A two-stage RTAM generation. This step assembles the desired RTAM 
facilities and link-edits them into the VS1 system. 

3. An NCP generation. This step defines SNA work stations as physical and 
logical units to NCP and to VTAM. The NCP generation is a two-step 
process. 

For a complete description of the RES generation process, see the OS/VS1 
RES System Programmer’s Guide. 

VS1 System Generation Requirements 

As part of a complete VS1 system generation, specify OPTIONS=REMOTE in 
the SCHEDULR macroinstruction to condition VS1 for the subsequent 
generation of RTAM. 

To make VTAM modules available to control communication with SNA work 
stations, specify ACSMETH=VTAM in the DATAMGT macroinstruction. 

Account Facility modules and RES modules are unconditionally copied during 
VS1 generation. 
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RTAM Generation 


RTAM generation is two-stage process that must be performed whenever a new 
VS1 release is installed. 


Stage 1 


Stage 1 is an assembly for which the input consists of the following 
installation-coded macroinstructions:/ 

TERMINAL: This is step 1 of stage 1. You must include the TERMINAL 
macroinstruction to associate an identification number with a work station and to 
specify the terminal device characteristics of the work station. Specify at least one 
TERMINAL macro for each work station. The first TERMINAL macroinstruction 
must immediately follow the last LINE macroinstruction. The following 
parameters define the terminal to RTAM. 

TERMID=tennid: Specifies the terminal number for this work station. 

TDESCR=(w,t,d,f): Specifies the terminal characteristics. 

w print width, specify 3 (132 characters), 
or specify 5 (150 characters) 
if you are using a forms control table entry 
with CPI=15 or a print image which has a CPI=15 when using 
a printer which supports a CPI of 15 
t terminal type, specify 8 (SNA terminal) 
d interface, specify 5 (SNA character string) 
f console support/transparency, specify 4 (console support 
with transparency) 

RDRS=rd: Specifies the number of readers to be used at this work station. If 
this operand is omitted, one reader is assumed. The range of rd is 0 through 9. 

The value specified here should be at least as large as the value specified for the 
prompt. Maximum number of host readers on display 37.0 during MSRJE 
subsystem member configuration at System/36. 

PTRS=pr: Specifies the number of printers at this work station. If this operand 
is omitted, one printer is assumed. The range of pr is 0 through 9. 

The value specified here should not be greater than the value specified for the 
prompt Maximum number of printers on display 36.0 during MSRJE subsystem 
member configuration at System/36. 

PCHS=pu: Specifies whether a punch is at this work station. If this operand is 
omitted, one punch is assumed. The range of pu is 0 through 9. 

The value specified here should not be greater than the value specified for the 
prompt Maximum number of punches on display 36.0 during MSRJE subsystem 
member configuration at System/36. 
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CNMSGNO=wtonum: Specifies the maximum number of WTO(R) buffers to 
be available for sending console messages to this work station. 

CONPR=value: Specifies the printer to be used for console output if console 
support is not specified. If only one printer is defined, that printer is used for 
console support. The number can be from 1 to the number of printers specified. 

Default: CONPR=l. 

PLGN=: Specifies whether to use permanent logon. If you want to use 
permanent logon, specify 1. If you do not want to use permanent logon, specify 
0. If you specify 1, you must also specify the NODE parameter of the 
TERMINAL macro. 

Default: PLGN=0. 

BUFXSIZ=length: Specifies the maximum size (256 or 512) of the VBUF that 
can be sent to/by the SNA work stations being defined. Specify 256 for 
System/36 MSRJE work station support. 

VBUF=tpnum: Specifies the number of teleprocessing buffers RTAM will use 
for this work station. RTAM always uses two buffers for input of data from 
SNA work stations; all other buffers that you specify here are used for data 
output to SNA work stations. 

If you specify less than 3 or omit this operand, RTAM assigns a value of 6 and 
issues a warning message. The value range for the VBUF parameter is any 
integer from 3 through 255. 

SESSLIM=value: Specifies the maximum number of SNA sessions that can be 
initiated for the work station. The value specified here should be at least as 
large as the value specified for Minimum number of sessions on display 34.0 
during MSRJE subsystem configuration at System/36. 

NODE=node name: Required if you specify PLGN= 1. Specifies the name of 
an LU macro in the 3705 NCP/PEP generation. The value of the LOCADDR 
parameter on this LU macro must match a logical unit specified for MSRJE on 
display 14.0 during line member definition. 

Note: If multiple locations are configured for a single line member (using 

CNFIGICF on System/36), then all LU macros that have LOCADDR 
parameters that match logical units specified on Display 14.0 (Remote 
System Logical Unit Assignments) must be defined here. This will allow 
any location to use any LU. 

RTAM: The RTAM macroinstruction determines the internal characteristics of 
RTAM. This is step 2 of stage 1. 

TPREAD=readn: Specifies the total number of readers associated with the 
maximum number of work stations that can be logged on at one time. You can 
find this value by adding up the number of readers for all work stations that will 
be logged on at one time. When a work station logs on, RTAM allocates all 
resources for all its job input readers (and also printers and punches). 

Therefore, if you specify too small a value for readn, a user might not be able to 
log on because of insufficient resources. 
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TPPRINT=printn: Specifies the maximum number of concurrent print 
operations. As recommended for TPREAD, you should specify a value for 
TPPRINT that is at least equal to the total number of printers at work stations 
allowed to log on at one time. You can find this value by adding up the number 
of printers for all work stations that will be logged on at one time. Resources 
are allocated as discussed for TPREAD. 

TPPUNCH=punchn: Specifies the maximum number of concurrent punch 
operations. As recommended for TPREAD and TPPRINT, you should specify a 
value for TPPUNCH that is at least equal to the total number of punches at 
work stations allowed to log on at one time. You can find this value by adding 
up the number of punches for all work stations that will be logged on at one 
time. Resource are allocated as discussed for TPREAD. 

MXINTBR=mxintbr: MXINTBR should equal the larger of 856 or the largest 
BUFXSIZ value specified on the TERMINAL macro. 

PASSWORD=password: Specifies a password that RTAM will use to provide 
additional protection when it issues an OPEN for the VTAM ACB. You must 
identify here the same password that you specified in the PRTCT= password 
operand of the VTAM-definition APL statement that identifies RTAM to 
VTAM as an application. 

SNACOMP=YES/NO: If any work station will use compression/expansion for 
input or print or punch output, specify or default to YES. 

CPACT=YES/NO: Specify NO, System/36 does not support compaction. 

APPLID=name: Specifies the name that RTAM will use when it issues OPEN 
ACB to establish the interface to VTAM. The name you select must also be 
used as the APPLID parameter when you logon to RTAM through VTAM and 
the label on the VTAM APPL statement which defines RTAM as a VTAM 
application. 

With these macroinstructions, you give the specifications that meet your particular 
requirements, and define the telecommunications network to be supported by 
RTAM. 

Output from stage 1 is a series of jobs, which constitute the input for stage 2. 


Stage 2 


Stage 2 consists of the execution of the job output from stage 1. The jobs consist 
of assemblies of the RTAM modules and two link edits of the RTAM modules. 
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Example RES Generation 


Date last changed 03/09/82 
SCP level OS/VS1 - 7 A 
PTF level PUT - 8201 
Configuration supported 


Term 

Wrk/Sta 

Line 

Number 

Type 

Cntl 

Number 

Type 

Cntl 

1 

CPU 

SNA 


Terminal Description for CPU-Type Work Stations 


TERMINAL TERMID=1, 

TDESCR=(3,8,5,35, 
RDRS=1, 

PTRS=1, 

PCHS=1, 
BUFXSIZ=256, 
CNMSGNO=5, 

C0NPR=1, 

VBUF=14, 

SESSLIM=1, 
CPACTBL=NO, 

PLGN=0 


SNA work station terminal number 
SNA work station attributes 
Number of readers/work station 
Number of printers/work station 
Number of punches/work station 
Maximum size of SNA VBUF 
Number of SNA write to operator buffers 
Use printer if no console support 
Number of SNA TP buffers 
Number of MSRJE SNA sessions 
No SNA compaction table 
No SNA permanent logon 


RTAM Description for RES System Generation 


RTAM TPREAD=6, 

TPPRINT=6, 

TPPUNCH=6, 
MXINTBR=856, 
MSGFCTR=25, 
STBUFNO=24, 
RMTOBJ=SYS1.RTAMOBJ, 
PASSWD=RMSC, 

PORTS=2, 

SNASCII=NO, 
HALFGEN=NO, 
SNACOMP=YES, 

CPACT=NO, 

CPACTDF=NO 

APPLID=RTAM 


Total number of readers 

Total number of printers 

Total number of punches 

Single interface buffer size 

Write to operator increase factor 

Number of subtask buffers 

Object library for RES generation 

Password for SNA 

Number of SNA ports 

No ASCII for SNA 

No halfgen 

SNA compression/expansion 
SNA compaction 
SNA compaction table 
Application ID for RES/VTAM 
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3705 NCP/PEP Generation 


The generation procedure for preparing a Network Control Program includes: 

• A generation language by which network configuration and program options 
are specified. 

• A library of macrodefinitions from which the source statements are expanded. 


Generation Language 


The generation language is made up of macroinstructions that fall into four 
categories according to the type of parameters they define. The types of macros 
are: 

1. System macros 

2. Configuration macros 

3. Block handling macros 

4. A generation delimiter macro 


System Macros 


The system macros provide information pertaining to hardware features with which 
the communications controller is equipped, certain network control program 
options, and program generation information such as data set names. 


Configuration Macros 


The configuration macros provide the information necessary to construct the 
control tables needed by the network control program. These tables are used to 
control the flow of data between the 3705 and remote stations or other 3705s, and 
between the 3705 and the host system processor. 

One group of these macros defines the characteristics of the elements in the 
network: 

• Line groups 

• Communications lines 

• Cluster controllers 

• Terminals 

• Components of terminals 

• SNA physical and logical units 
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A macro is coded for each element in the network. The macros must be arranged 
in a specific order to associate a particular communications line with a particular 
line group, or a particular station or a particular SNA physical unit. 

The rest of the configuration macros provide the following types of information: 


• Information needed for data transfer between the communications access 
method and the network control program. 

• Information describing the communication scanner(s) installed in the 3705. 


• Definition of the remaining control tables necessary to control the network. 



If MSRJE is sharing the communications line, you can use multiple unformatted 
system services (USS) tables. For example, if MSRJE and 3270 device emulation 
are sharing a line, you can use: 

• One table with messages defined for message levels 0 and 10 for 3270 device 
emulation 

• Another table without messages defined for message levels 0 and 10 for 
MSRJE 

Note: For MSRJE , you can define messages for message levels 0 and 10 only if you 
use a formatted logon. 


Block Handling Macros 


The block handling macros apply to messages transmitted over binary synchronous 
communications lines. 

Generation Delimiter Macros 

The generation delimiter macro ends the program generation input stream. 

When the programmer has coded the generation macros that describe the network 
to be controlled, the control program is generated using the generation procedure. 
The procedure is executed as a series of jobs in the host processor. 
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PEP Generation for a 3705-11 


Date last changed 03/10/81 
NCP level 7.1 (NCP REL2) 
PTF level PUT - 8011 
Configuration supported 


UCB 

3705 



LINE 

LINE 

TERM 

SUBCHAN 

LINE ADDR 

USE 

SPEED 

CNTL 

NAME 

USAGE 


0A6 

NCP/LSD 

2400 

SDLC 

L0A6 

SNA 


0A0 

NCP/SW 

2400 

SDLC 

L0A0 

SNA 


The following shows an example of what you would write for a nonswitched line. 


LSGRP2 GROUP DIAL=NO, 

LNCTL=SDLC, 
ACTIVTO=420.0, 
REPLYTO=1.0, 
TEXTO=3, 
VIRTUAL=NO, 
INTPRI=1, 
DATRATE=HIGH , 
SPDSEL=NO, 
SERVLIM=4, 
NEWSYNC=NO, 
HDXSP=YES, 
MAXOUT=7, 
PASSLIM=7, 
PUDR=YES, 
ANS=STOP, 
IRETRY=YES, 
BATCH=YES f 
LUDR=YES, 
PACING=(7,1) , 
SSCPFM=USSSCS, 
MODETAB=RMSCMT, 
USSTAB=RMSCLT, 
DISCNT=NO, 
VPACING=7, 
TYPE=NCP 


Group macrodefinition 

(default) 

(default) 

(default) 

(default) 

(default) 

(default) 

(default) 

(default) 

(default) 

(default) 

(default) 

(default) 

(default) 

(default) 

(default) 

(default) 

(default) 

(default) VTAM only 
VTAM only 
VTAM only 
VTAM only 
VTAM only 


L0A6 LINE ADDRESS=(OA6), 

DUPLEX=HALF, 
SPEED=2400, 
NRZI=YES, 
CLOCKING=EXT, 
POLLED=YES, 
PAUSE=0, 

HDXSP=YES, 
RETRIES=(5,10,3), 
MAXPU=8, 

MAXLU=16, 
MAXDATA=265, 

ISTATUS=INACTIVE 


Line macrodefinition 


(default) 

(default; MSRJE requires 
265) 


8-34 Multiple Session Remote Job Entry Guide 



SERVICE ORDER=(PU0A6A,PU0A6B), Service macrodefinition 
MAXLIST=8 

PU0A6A PU ADDR=C1, Physical unit definition 

PUTYPE=2, 

ISTATUS=INACTIVE 

LU0A6A1 LU LOCADDR=1, Logical unit definition 

ISTATUS=INACTIVE 

PU0A6B PU ADDR=C2 , Physical unit definition 

PUTYPE=2, 

ISTATUS=INACTIVE 

LU0A6B1 LU L0CADDR=1, Logical unit definition 

ISTATUS=INACTIVE 


The following shows an example of what you would write for a switched line. 


SWGRP2 GROUP DIAL=YES, 

LNCTL=SDLC, 
REPLYT0=1.0, 
TEXTTO=3, 
VIRTUAL=NO, 
HDXSP=YES, 
ANS=STOP f 
INTPRI=1, 
DATRATE=HIGH, 
SPDSEL=NO, 
ANSTONE=NO, 
RING=NO, 

PAUSE=0 f 
MAXPU=1 f 
TYPE=NCP 

L0A0 LINE ADDRESS=(0A0) f 
CALL=INOUT, 
DUPLEX=HALF, 
SPEED=2400 r 
NRZI=YES, 
CLOCKING=EXT, 
HDXSP=YES, 

PAUSE=0, 
POLLED=YES, 
RETRIES=(5,10,3), 
ISTATUS=ACTIVE, 
VPACING=(2,1) 

PU0A0 PU PUTYPE=(1,2), 
MAXLU=32 


Group macrodefinition 
(default) 

(default) 

(default) 

(default) 

(default) 

(default) 

(default) 

(default) 

(default) 

(default) 

(default) 

(default) 

(default) 

Line macrodefinition 


VTAM only 
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MEMBER NAME APPLRTAM 

RTAM1 VBUILD TYPE=APPL 

RTAM APPL ACBNAME=RTAM , 

AUTH=(ACQ , NOCNM,PAS S,NOPO,VPACE) , 
AUTHEXIT-NO, 

EAS-10, 

MODETAB=RMSCMT, 

PARSESS=NO, 

PRTCT=RMSC, 

VPACING-2 


MEMBER NAME SWMSRJE1 

SSUNGL VBUILD TYPE—SWNET, 
MAXNO=5, 

MAXGRP—1 

PU1C PU ADDR—C3, 

IDBLK-03E, 
IDNUM=00806, 
MAXDATA=265, 

DISCNT—(NO,F), 
IRETRY=YES, 

ISTATUS—ACTIVE, 
MAXOUT=7, 

MAXPATH=1, 
PASSLIM=7, 
PUTYPE=2 

PATH1 PATH DIALNO=60534, 

GID=1, 

GRPNM=SWGRP 2, 
PID=1, 

REDIAL-0, 

USE-NO 

LU1C1 LU LOCADDR-1, 

BATCH-YES, 

DLOGMOD—SXXRJE, 
ISTATUS-ACTIVE, 
LOGTAB-RMSCIT, 
MODETAB-RMSCMT, 
PACING-(3), 
SSCPFM—USSSCS, 
USSTAB-RMSCLT, 
VPACING-(2) 


define as switched major node 
5 dial numbers 
1 path group 
minor node name 
bits 16-27 of VTAM station ID 
bits 28-47 of VTAM station ID 
maxdata that pu can receive in 
one PIU 

disconnect the phone 
repoll immediate after idle 
detect 

PU is activated at start up 
send 7 PIUs before PU must 
respond 
dial in only 
same as maxout 

System/36 is type 2 PU (3770) 

dial characters for dial out 

group identifier 

group macro name in NCP 

path identifier 

don’t re-dial 

don't attempt dial out 

address on physical unit 
processing priority (yes-low 
priority) 

default logmode entry name 
LU is activated at start up 
interpret table name 
default logmode table name 
data transfer between LU and NCP 
default to VTAM USSSCS 
default to USS log table 
data transfer VTAM to NCP 
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MEMBER NAME MODETAB 

//MODETAB JOB ,DKOLSON,CLASS=A 

//TABLE EXEC ASMHCL,PARM.ASM= 1 OBJ,NODECK 1 , 
// PARM.LKED=(xREF,LIST,LET,NCAL) 

//SYSIN DD * 

TITLE 1 RMSC - LOGON MODE TABLE* 

RMSCMT MODETAB 
EJECT 


MSRJE FOR SYSTEM/36 - programmer 


SXXRJE 


MODEENT LOGMODE=SXXRJE, 
FMPROF=X * 03 1 , 
TSPROF=X'03 *, 
PRIPROT=X'A3 1 , 
SECPROT=X* A3' , 
COMPROT=X'7080 * , 
SSNDPAC=X'00 *, 
SRCVPAC=X'00', 
RUSIZES=X'8585', 
PSNDPAC=X'00', 
PSERVIC=X'01102000F1 

MODEEND 
END RMSCMT 


entry name 
FM profile 
TS profile 
PLU protocol 
SLU protocol 
common protocol 
secondary send pacing 
secondary receive pacing 
RU size (256) 
primary send pacing 
00C00000010040' LU presentation 
services 
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MEMBER NAME USSTAB 
//USSTAB JOB ,DKOLSON,CLASS=B 
//TABLE EXEC ASMHOL,PARM.ASM= 1 OBJ,NODECK', 

// PARM.LKED=(XREF,LIST,LET,NCAL) 

//SYSIN DD * 

TITLE 1 RMSC - UNFORMATTED SYSTEM SERVICES DEFINITION TABLE' 
RMSCLT USSTAB TABLE=STDTRANS 
LOGON USSCMD CMD=LOGON 
USSPARM PARM=APPLID 
USSPARM PARM=LOGMODE 
USSPARM PARM=DATA 


LOGOFF 


USSCMD CMD=LOGOFF 
USSPARM PARM=APPLID 
USSPARM PARM=TYPE,DEFAULT=UNCOND 
USSPARM PARM=HOLD,DEFAULT=NO 


SIGNOFF 


USSCMD CMD=SIGNOFF 

USSPARM PARM=APPLID 
USSPARM PARM=TYPE,DEFAULT=UNCOND 
USSPARM PARM=HOLD , DEFAULT=NO 


MESSAGES 


USSMSG MSG=1,TEXT='INVALID COMMAND SYNTAX' 
USSMSG MSG=2,TEXT ='% COMMAND NOT RECOGNIZED' 
USSMSG MSG=3,TEXT ='% PARAMETER UNRECOGNIZED' 
USSMSG MSG=4,TEXT ='% PARAMETER INVALID' 

USSMSG MSG=5,TEXT='UNSUPPORTED FUNCTION' 

USSMSG MSG=6,TEXT='SEQUENCE ERROR' 

USSMSG MSG=7,TEXT=*SESSION NOT BOUND' 

USSMSG MSG=8,TEXT='INSUFFICIENT STORAGE' 

USSMSG MSG=9,TEXT='MAGNETIC CARD DATA ERROR' 
USSMSG MSG=11,TEXT='SESSION ENDED' 

USSMSG MSG=12,TEXT='REQUIRED PARAMETER OMITTED' 
USSMSG MSG=13,TEXT='IBMECHO %' 


STDTRANS DC 
DC 
DC 
DC 
DC 
DC 
DC 
DC 
DC 
DC 
DC 
DC 
DC 
DC 
DC 
DC 
END 
END 


X'000102030405060708090A0B0C0D0E0F' 
X*101112131415161718191A1B1C1D1E1F* 
X'202122232425262728292A2B2C2D2E2F' 
X* 303132333435363738393A3B3C3D3E3F' 
X'404142434445464748494A4B4C4D4E4F' 
X'505152535455565758595A5B5C5D5E5F' 
X'606162636465666768696A6B6C6D6E6F' 
X'707172737475767778797A7B7C7D7E7F' 
X'808182838485868788898A8B8C8D8E8F' 
X'909192939495969798999A9B9C9D9E9F' 
X'A0A1A2A3A4A5A6A7A8A9AAABACADAEAF' 
X'BOB1B2B3B4B5B6B7B8B9BABBBCBDBEBF' 
X'C0C1C2C3C4C5C6C7C8C9CACBCCCDCECF' 
X'DOD1D2D3D4D5D6D7D8D9DADBDCDDDEDF' 
X'EOE1E2E3E4E5E6E7E8E9EAEBECEDEEEF' 
X'FOF1F2F3F4F5F6F7F8F9FAFBFCFDFEFF' 
USSEND 
RMSCLT 


8-38 Multiple Session Remote Job Entry Guide 



VSE/POWER Host System Generation for SNA/MSRJE 


To generate POWER for operation with System/36 MSRJE, you must specify 
parameters of the POWER generation macros and subsequently process these 
macros. For a complete description of VSE/POWER generation, see the 
VSE/POWER Installation and Operation Guide. 


POWER Macro 


The following parameters of the POWER macro are used in defining System/36 
MSRJE work stations. 

COPYSEP: Specifies whether VSE/POWER should produce separator 
pages/cards between each copy of an output file. If NO is specified, the separator 
pages/cards are suppressed. If YES is specified, separator pages/cards are 
included between each copy of an output file. However, copy separation is done 
only for nonzero JSEP specification, defined either during VSE/POWER 
generation or in a JECL (Job Entry Control Language) statement. 

Default: YES. 

DBLK: Specifies the block size of data file records and, consequently, the size of 
each data buffer. Data buffers are used as I/O areas by the execution processors, 
readers/writers, and RJE routines. The value specified for DBLK must be an 
integer in the range 544 to 2008. 

JSEP=n,m: Specifies that special pages or cards are to be included in the output to 
separate job entries, n specifies the number of separator pages to be printed across 
perforations, m specifies the number of separator cards, n and m may be any digit 
from 0 through 9. The minimum number of separator cards is 3. For print output, 
one additional page as specified by n will be printed except if 0 is specified. If 
JSEP is omitted, (0,0) is assumed. 

SNA: Specifies POWER as a VTAM application program. The following SNA 
subparameters are used in defining System/36 MSRJE work stations. 

LUCOUNT: Specifies the total number of LU-to-LU sessions that can exist at 
one time. Each work station potentially represents multiple sessions. A value in 
the range 1 through 200 can be specified. System/36 MSRJE supports up to 46 
LU-to-LU sessions. 

PASSWORD: Specifies in 1 through 8 alphameric characters, the password 
presented to VTAM. If specified, the password must match the PRTCT 
parameter of the VTAM APPL application definition statement. 

Default: No password. 

APPLID: Specifies, in 1 through 8 alphameric characters, the name that the 
host has assigned to POWER. If specified, the value must match the name field 
of the VTAM APPLID definition for POWER. 

Default: POWER. 
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PRMT Macro 


The PRMT macro and its parameters define the hardware characteristics of an RJE 
terminal. At least one PRMT macro must be supplied for each user. The PRMT 
macros must be specified in ascending sequence according to their remote-IDs, and 
the definitions for non-SNA remote-IDs must precede the definitions for SNA 
remote-IDs. The following parameters make up the PRMT macro. 

REMOTE: Specifies an identification number for the work station. Work stations 
are numbered consecutively from 1 to 200. The first must be specified as 1, and 
succeeding work stations must be specified in increments of 1. 

TYPE: For SNA support, the terminal must be specified as LUT1. 

| CONSOLE: May be specified only for an SNA work station and only if this work 
j station has a line printer in addition to the normal terminal console. 

YES causes VSE/POWER to interrupt the outbound printer flow whenever 
messages are generated for the remote operator. 

NO prevents VSE/POWER from interrupting an outbound printer flow for the 
transmission of messages to the remote operator. In this case, the messages are 
collected and submitted to the operator after POWER END OF JOB has been 
I reached. 

PSWRD: Specifies the security password that may have been defined for the 
remote work station being described. The password must match the password 
contained in the user data of the LOGON command. 

The value specified must match the entry made for the password operand of the 
DATA parameter in the host LOGON,specified on display 35.0 during MSRJE 
subsystem configuration at System/36. 

SESSLIM: Specifies the maximum number of SNA sessions that can exist 
concurrently. The maximum value that can be specified is 6. 

The value specified here must be at least as large as the value specified for the 
prompt Minimum number of sessions on display 34.0 during MSRJE subsystem 
member configuration at System/36. 

CMPACT: Specifies the name of the default compaction table to be used for this 
remote work station. System/36 does not support compaction. 

LU: Specifies the symbolic name, or names, of this work station as they are known 
to VTAM. These names must be the same ones used in the VTAM logical unit 
definitions. 

Note: If multiple locations are configured for a single line member definition (using 
CNFIGICF on System/36), then all LU names that correspond to MSRJE 
sessions defined in the System/36 line member should be defined here . This 
will allow any location to use any LU. 

For additional information on VSE/POWER generation, refer to the 
VSE/POWER Installation and Operations Guide. 
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Appendix A. Host Subsystem Work Sheets 


The following work sheets should be used to coordinate System/3 6 MSRJE 
configuration and the host subsystem generation. The values that must be the same 
for System/36 and the host subsystem are defined by indicating the System/36 
CNFIGICF procedure display number and prompt and the host subsystem 
generation parameter. 

It is recommended that you either have the host system personnel fill out the work 
sheet and then use those values to configure MSRJE, or configure MSRJE, fill out 
the work sheet and then give the work sheet to the host system personnel. 

Note: Changes to the host subsystem parameters and their default values sometimes 
occur between releases. Therefore, the information given here may not exactly 
reflect the host subsystem release with which you are operating. 
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BSC 

SYSTEM/36 MULTIPLE SESSION REMOTE JOB ENTRY 
JES2 HOST SUBSYSTEM WORK SHEET 


JES2 BSC SIGNON 


Enter the text to be used as the SIGNON command that the JES2 host subsystem 
is expecting from System/36. The value specified on display 35.0 during 
subsystem member configuration at System/36 must match the value expected by 
JES2. 


12 3 4 

1 0 0 0 0 

4 5 6 7 8 

1 0 0 0 0 

JJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJ I UJ I I LL 


JES2 uses the following SIGNON command format: 

1 2 
1 6 5 

/*SIGNON fREMOTEnn) [passwrdl] 
^RMTnnn J 


7 

3 

[passwrd2] 

S7909030-0 


Generation Parameter Description 

System/36 

CNFIGICF 

Display 

Host 

Configuration 

Entry 

Host 

Default 

Value 

The REMOTEnn or RMTnnn parameter begins in 
position 16 and must match the value specified for 
System/36 in the RMTnnn parameter of the JES2 work 
station definition. 

35.0 



The passwrdl parameter is optional and, if used, begins 
in position 25 and must match the value specified for 
the PASSWORD subparameter of the LINEnnn 
parameter during definition of remote work stations for 
JES2 at the host system. 

35.0 


No password 

The passwrd2 parameter is optional and, if used, must 
begin in position 73 and must match the value specified 
for the PASSWORD subparameter of the RMTnnn 
parameter during remote work station definition for 

JES2 at the host system. 

35.0 


No password 
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JES2 BSC Configuration 


Generation Parameter Description 

System/36 

CNFIGICF 

Display 

Host 

Configuration 

Entry 

Host 

Default 

Value 

The value specified for the MLBFSIZ JES2 
initialization parameter. The value specifed for Buffer 
length on display 11.0 during line member 
configuration at System/36 must match this value. 

11.0 


400 

The value specified for the NUMRD subparameter of 
the RMTnnn parameter on the JES2 work station 
definition. The value specified for Maximum number of 
host readers on display 37.0 during subsystem member 
configuration at System/36 must be less than or equal 
to this value. 

37.0 


1 

The value specified for the NUMPR subparameter of 
the RMTnnn parameter on the JES2 work station 
definition. The value specified for Maximum number of 
printers on display 36.0 during subsystem member 
configuration at the system/ 3 6 must be at least as large 
as this value. 

36.0 


1 

The value specified for the NUMPU subparameter of 
the RMTnnn parameter on the JES2 work station 
definition. The value specified for Maximum number of 
punches on display 36.0 during subsystem member 
configuration at System/36 must be at least as large as 
this value. 

36.0 


0 

Whether TRANSP or NOTRANSP is specified on the 
LINEnnn parameter and the RMTnnn parameter for 

JES2. TRANSP indicates that transparency is 
supported; NOTRANSP indicates that transparency is 
not supported. TRANSP must be specified on both the 
LINEnnn and RMTnnn parameters if transparency is to 
be used with System/36. Transparency can be selected 
at System/3 6 for the Transparency? prompt on display 
37.0 during subsystem member configuration. 

37.0 


NOTRANSP 
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BSC 

SYSTEM/36 MULTIPLE SESSION REMOTE JOB ENTRY 
JES3 HOST SUBSYSTEM WORK SHEET 


JES3 BSC SIGNON 

Enter the text to be used as the SIGNON command that the JES3 host subsystem 
is expecting from System/36. The value specified on display 35.0 during 
subsystem member configuration at System/36 must match the value expected by 
JES3. 


12 3 4 

1 0 0 0 0 

4 5 6 7 8 

1 0 0 0 0 

IJ_l LLLI I I IJ I I LLLLLLLl! I LUJJJJ IJJJ LLLLL 


JES3 uses the following SIGNON command format: 

12 2 3 

1 6 2 5 5 

/♦SIGNON namexfA] passwrdl passwrd2 


Generation Parameter Description 

System/36 

CNFIGICF 

Display 

Host 

Configuration 

Entry 

Host 

Default 

Value 

The namex parameter begins in position 16 and must 
match the value specified for System/36 by the N 
parameter in the RJPTERM statement during JES3 
generation at the host system. 

35.0 



The A in position 22 is optional and, if used, defines 
System/36 as a programmable RJE work station with 
readers that do not require operator intervention 
(automatic readers). 

35.0 



The passwrdl parameter begins in position 25 and must 
match the value specified for the P subparameter of the 
RJPLINE parameter during JES3 generation at the 
host system. The value is 1 through 8 alphameric 
characters. 

35.0 


8 blanks 

The passwrd2 parameter begins in position 35 and must 
match the value specified for the P subparameter in the 
RJPTERM statement during JES3 generation at the 
host system. The value is 1 through 8 alphameric 
characters. 

35.0 


8 blanks 
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JES3 BSC Configuration 


Generation Parameter Description 

System/36 

CNFIGICF 

Display 

Host 

Configuration 

Entry 

Host 

Default 

Value 

The value specified for the B subparameter of the 
RJPTERM statement during JES3 work station 
definition at the host system. The value specified for 
Buffer length on display 11.0 during line member 
configuration at System/36 must match this value. 

11.0 


400 

The value specified for the RD subparameter of the 
RJPTERM statement during JES3 work station 
definition. The value specified for Maximum number of 
host readers on display 37.0 during subsystem member 
configuration at System/36 must be less than or equal 
to this value. 

37.0 


0 

The value specified for the PR subparameter of the 
RJPTERM statement during JES3 work station 
definition. The value specified for Maximum number of 
printers on display 36.0 during subsystem member 
configuration at System/3 6 must be at least as large as 
this value. 

36.0 


0 

The value specified for the PU subparameter of the 
RJPTERM statement during JES3 work station 
definition. The value specified for Maximum number of 
punches on display 36.0 during subsystem member 
configuration at System/36 must be at least as large as 
this value. 

36.0 


0 

Whether F=NTRS is specified on the RJPTERM 
statement during JES3 work station definition. 

F=NTRS indicates that transparency is not supported. 
Transparency can be selected at System/36 for the 
Transparency? prompt on display 37.0 during 
subsystem member configuration. 

37.0 


Transparency 
is assumed 
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BSC 

SYSTEM/36 MULTIPLE SESSION REMOTE JOB ENTRY 
RES HOST SUBSYSTEM WORK SHEET 


RES BSC LOGON 

Enter the text to be used as the LOGON command that the RES host subsystem is 
expecting from System/36. The value specified on display 35.0 during subsystem 
member configuration at System/36 must match the value expected by RES. 

12 3 4 

1 0 0 0 0 

J J J J J J J J J J J J J J J J J J J J J J J J J J J J J J J J J J J J J J J_ 

4 5 6 7 8 

1 0 0 0 0 

_l IJ I IJ IJ II II IJJJ IJ I IJ IJ J_l_l J J J J J J J J J_l_l J J_ 


RES uses the following LOGON command format: 

LOGON userid[/password] TERM(termid) [PROG(procname)] 


/NOTICES 1 
/NONOTICES] 


f MAIL 
^NOMAILj 


Generation Parameter Description 

System/36 

CNFIGICF 

Display 

Host 

Configuration 

Entry 

Host 

Default 

Value 

The userid parameter must match the value specified 
for System/36 on the ADD subcommand of the 
account command. 

35.0 



The password parameter is optional and, if used, must 
be separated from the userid by a slash (/) and must 
match the value specified in the ADD command 
(during RTAM generation) for the associated userid. 

The value is 1 through 8 alphameric characters. 

35.0 



The TERM parameter identifies the RJE work station 
and must match the value specified for System/36 in 
the TERMID parameter of the TERMINAL macro for 
the RTAM generation. 

35.0 



The PROC parameter allows you to specify a cataloged 
procedure at the host system that is to be executed as a 
part of the logon process. 

35.0 
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RES BSC Configuration 


Generation Parameter Description 

System/36 

CNFIGICF 

Display 

NOTICES/NONOTICE allows you to specify whether 
all general notices from RES are to be listed at 

System/36 after logon. NOTICES, the default, 
specifies that notices will be listed; NONOTICES 
specifies that notices are not to be listed. 

35.0 

MAIL/NOMAIL allows you to specify whether 
messages directed to System/3 6 are to be automatically 
listed after logon. MAIL, the default, specifies that 
messages are to be listed. NOMAIL specifies that 
messages are not to be automatically listed. 

35.0 

The value specified for the TPBFSIZ parameter of the 
RTAM macro for the RTAM stage 1 generation at the 
host system. The value specified for Buffer length on 
display 11.0 during line member configuration at 
System/36 must match this value. 

11.0 

The value specified for the RDRS parameter of the 
TERMINAL macro for the RTAM stage 1 generation. 

The value specified for Maximum number of host 
readers on display 37.0 during subsystem member 
configuration at System/36 must be less than or equal 
to this value. 

37.0 

The value specified for the PTRS parameter of the 
TERMINAL macro for the RTAM stage 1 generation. 

The value specified for Maximum number of printers on 
display 36.0 during subsystem member configuration at 
System/36 must be at least as large as this value. 

36.0 

The value specified for the PCHS parameter of the 
TERMINAL macro for the RTAM stage 1 generation. 

The value specified for Maximum number of punches on 
display 36.0 during subsystem member configuration at 
System/36 must be at least as large as this value. 

36.0 

The value specified for subparameter 4 of the TDESCR 
parameter of the TERMINAL macro for the RTAM 
stage 1 generation. If that value is 2, transparency for 
the terminal is not supported. If the value is 3, 
transparency for the terminal is supported. The value 
specified for subparameter 2 of the LDESCR 
parameter of the LINE macro for the RTAM stage 1 
generation. If that value is 0, transparency for the line 
is not supported. If the value is 1, transparency for the 
line is supported. These values correspond to the 
Transparency? prompt on display 37.0 during 
subsystem member configuration at System/36. 

37.0 


Host Host 

Configuration Default 

Entry Value 
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BSC 

SYSTEM/36 MULTIPLE SESSION REMOTE JOB ENTRY 
VM/370 RSCS HOST SUBSYSTEM WORK SHEET 


VM/370 RSCS SIGNON 

Enter the text to be used as the SIGNON command that the RSCS host subsystem 
is expecting from System/36. The value specified on display 35.0 during 
subsystem member configuration as System/3 6 must match the value expected by 
RSCS. 

12 3 4 

1 0 0 0 0 

4 5 6 7 8 

1 0 0 0 0 


RSCS uses the following SIGNON command format: 

1 2 
1 6 5 

/♦SIGNON REMOTEnn[password] 


Generation Parameter Description 

System/36 

CNFIGICF 

Display 

Host 

Configuration 

Entry 

Host 

Default 

Value 

The REMOTEnn parameter begins in position 16 and 
must match the value specified by the Mm parameter 
for System/36 in the START command for RSCS at 
the host system. 

35.0 



The password parameter is optional and, if used, begins 
in position 25 and must match the value specified for 
password in the START command at the host system. 

The value is 1 through 8 alphameric characters. 

35.0 


No password 
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VM/370 RSCS Configuration 


Generation Parameter Description 

System/36 

CNFIGICF 

Display 

Host 

Configuration 

Entry 

Host 

Default 

Value 

The value specified for the Bnnnn parameter of the 

RSCS START command. The value specifed for 

Buffer length on display 11.0 during line member 
configuration at System/36 must match this value. 

11.0 


400 

RSCS supports one reader only. Specify 1 for the 
Maximum number of host readers on display 37.0 during 
subsystem member configuration at System/36. 

37.0 

i 


RSCS supports 0 or 1 printer. If your application 
generates print output that is returned to System/36, 
specify 1; otherwise, specify 0. The value specified for 
Maximum number of printers on display 36.0 during 
subsystem member configuration at System/36 must be 
at least as large as this value. 

36.0 



RSCS supports 0 or 1 punch. If your application 
generates punch output that is returned to System/36, 
specify 1; otherwise, specify 0. The value specified for 
Maximum number of punches on display 36.0 during 
subsystem member configuration at System/36 must be 
at least as large as this value. 

36.0 



RSCS always sends punch data in transparent mode 
and accepts transparent data. Specify Y for the 
Transparency? prompt on display 37.0. 

37.0 

Y 

1 
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SNA 

SYSTEM/36 MULTIPLE SESSION REMOTE JOB ENTRY 
NCP/VTAM CONFIGURATION WORK SHEET 


Generation Parameter Description 

System/36 

CNFIGICF 

Display 

Host 

Configuration 

Entry 

Host 

Default 

Value 

The values specified for the IDNUM parameter of PU 
macro during NCP/VTAM generation. The value 
specified for Local system’s station XID in hexadecimal 
on display 13.0 during line member configuration at 
System/36 must be equal to this value. 

13.0 



The value specified for the ADDR parameter of the PU 
macro during NCP/VTAM generation. The value 
specified for Local system’s station address on display 

13.0 during line member configuration at System/36 
must be the same as this value. 

13.0 



The value specified in the START procedure for 
NCP/VTAM as the system services control point 
identifier (SSCPID). The value specified for SSCP 
identification on display 13.0 during line member 
configuration at System/36 must be the same as this 
value. 

13.0 



The values specified for the LOCADDR parameters of 
the LU macros during NCP/VTAM generation. The 
values selected on display 14.0 during line member 
configuration at System/36 must equal these values. 

Up to 255 LU addresses can be assigned to System/36. 

14.0 



The name assigned to the log mode table to be used for 
MSRJE. The name is specified by the MODETAB 
parameter of the PU macro. 

35.0 
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SNA 

SYSTEM/36 MULTIPLE SESSION REMOTE JOB ENTRY 
JES2 HOST SUBSYSTEM WORK SHEET 


JES2 SNA LOGON 

Enter the text to be used as the LOGON command that the JES2 host subsystem is 
expecting from the System/36. The value specified on display 35.0 during 
subsystem member configuration at System/36 must match the value expected by 
JES2. 


12 3 4 

1 0 0 0 0 

_I_M_I_IJ_I_I_I_I_I_I_IJ_I_IJ_I_I_I_IJJ_I_I_I_I_I_I_I_I_I_I_I_I_IJ_I_I_ 
4 5 6 7 8 

1 0 0 0 0 

IJ I IJ IJ IJ l_l I l_l I I.IJ IJ I l_l l_l 1.1 1.1 III l_l I I I I I 


JES2 uses the following LOGON command format: 

LOGON APPLID(JES2)[LOGMODE(modename)][DATA(RMTnn [,password1] [,password2])] 


Generation Parameter Description 

System/36 

CNFIGICF 

Display 

Host 

Configuration 

Entry 

Host 

Default 

Value 

The value for the APPLID parameter is normally 
specified as JES2. 

35.0 


JES2 

The value entered for the LOGMODE parameter, if 
used, specifies the name of an entry in a table at the 
host system that contains the operating parameters for 
SNA communications. You should obtain the name of 
the LOGMODE entry from the host system personnel. 

The table that contains the entry specified is selected 
by the MODETAB parameter of the PU macro during 
NCP/VTAM generation at the host system. The table 
itself is defined using the MODEENT macro. 

35.0 



The values entered for the DATA parameter. 




The RMTnnn parameter specifies the terminal number 
of System/3 6 as specified in the RMTnnn parameter of 
the host system’s remote terminal description. 

35.0 



The passwordl parameter is optional and, if specified, is 

1 through 8 alphameric characters and must match the 
password specified for the PASSWORD subparameter 
of the LINEnnn parameter during the definition of a 
remote work station for JES2 at the host system. 

35.0 


8 blanks 
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JES2 SNA Configuration 


Generation Parameter Description 

System/36 

CNFIGICF 

Display 

Host 

Configuration 

Entry 

Host 

Default 

Value 

The password2 parameter is optional and, if used, is 1 
through 8 alphameric characters and must match the 
value specified for the PASSWORD parameter of the 
RMTnnn parameter during remote work station 
definition for JES2 at the host system. 

35.0 


No password 

The value specified for the NUMRD subparameter of 
the RMTnnn parameter on the JES2 work station 
definition. The value specified for Maximum number of 
host readers on display 37.0 during subsystem member 
configuration at System/3 6 must be less than or equal 
to this value. 

37.0 


i 

The value specified for the NUMPR subparameter of 
the RMTnnn parameter on the JES2 work station 
definition. The value specified for Maximum number of 
printers on display 36.0 during subsystem member 
configuration at System/36 must be at least as large as 
this value. 

36.0 


0 

The value specified for the NUMPU subparameter of 
the RMTnnn parameter on the JES2 work station 
definition. The value specified for Maximum number of 
punches on display 36.0 during subsystem member 
configuration at System/36 must be at least as large as 
this value. 

36.0 


0 
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SNA 

SYSTEM/36 MULTIPLE SESSION REMOTE JOB ENTRY 
JES3 HOST SUBSYSTEM CONFIGURATION WORK SHEET 


JES3 SNA LOGON 


Enter the text to be used as the LOGON command that the JES3 host subsystem is 
expecting from System/36. The value specified on display 35.0 during subsystem 
member configuration as System/36 must match the value expected by JES3. 

12 3 4 

1 0 0 0 0 

4 -5 6 7 8 

1 0 0 0 0 

I l_l III l I I I IJ UJ 1.1 IJJJJ LLLUJJJJJJJJJ.LLL 


JES3 uses the following LOGON command format: 

LOGON APPLID(JES3)[LOGMODE(modename)][DATA(wsname,password)] 


Generation Parameter Description 

System/36 

CNFIGICF 

Display 

Host 

Configuration 

Entry 

Host 

Default 

Value 

The value for the APPLID parameter is normally 
specified as JES3. 

35.0 


JES3 

The value entered for the LOGMODE parameter, if 
used, specifies the name of an entry in a table at the 
host system that contains the operating parameters for 
SNA communications. You should obtain the name of 
the LOGMODE entry from the host system personnel. 

The table that contains the entry specified is selected 
by the MODETAB parameter of the PU macro during 
NCP/VTAM generation at the host system. The table 
itself is defined using the MODEENT macro. 

35.0 



The values entered for the DATA parameter. 




The wsname parameter must match the value specified 
for System/36 by the N parameter in the RJPWS 
statement during JES3 generation at the host system. 

35.0 



The password parameter must match the value specified 
for the P parameter of the RJPWS parameter during 

JES3 generation at the host system. The value is 1 
through 8 alphameric characters. 

35.0 
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JES3 SNA Configuration 


Generation Parameter Description 

System/36 

CNFIGICF 

Display 

Host 

Configuration 

Entry 

Host 

Default 

Value 

The value specified for the RD subparameter of the 
RJPWS statement during JES3 work station definition. 
The value specified for Maximum number of host 
readers on display 37.0 during subsystem member 
configuration at System/3 6 must be less than or equal 
to this value. 

37.0 


i 

The value specified for the PR subparameter of the 
RJPWS statement during JES3 work station definition. 
The value specified for Maximum number of printers on 
display 36.0 during subsystem member configuration at 
System/36 must be at least as large as this value. 

36.0 


i 

The value specified for the PU subparameter of the 
RJPWS statement during JES3 work station definition. 
The value specified for Maximum number of punches on 
display 36.0 during subsystem member configuration at 
System/36 must be at least as large as this value. 

36.0 


0 
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SNA 

SYSTEM/36 MULTIPLE SESSION REMOTE JOB ENTRY 
RES HOST SUBSYSTEM CONFIGURATION WORK SHEET 


RES SNA LOGON 

Enter the text to be used as the LOGON command that the RES host subsystem is 
expecting from System/36. The value specified on display 35.0 during subsystem 
member configuration as System/3 6 must match the value expected by RES. 

12 3 4 

1 0 0 0 0 


4 5 6 7 8 

1 0 0 0 0 


RES uses the following LOGON command format: 

LOGON APPLID(RTAM)[ LOGMODE(mode)] 


DATA ( ' userid[ /password] TERM (termid) [ PROC (procname)] 

^NOTICES 1 

f MAIL 1 

■)' 


(JNIONOTICESj 

^NOMAILJ 



S7909032-0 


Generation Parameter Description 

System/36 

CNFIGICF 

Display 

Host 

Configuration 

Entry 

Host 

Default 

Value 

The value for the APPLID parameter is normally 
specified as RTAM. 

35.0 


RTAM 

The value entered for the LOGMODE parameter, if 
used, specifies the name of an entry in a table at the 
host system that contains the operating parameters for 
SNA communications. You should obtain the name of 
the LOGMODE entry from the host system personnel. 

The table that contains the entry specified is selected 
by the MODETAB parameter of the PU macro during 
NCP/VTAM generation at the host system. The table 
itself is defined using the MODEENT macro. 

35.0 



The values entered for the DATA parameter. 




The userid parameter must match the value specified 
for System/36 on the ADD subcommand of the 
ACCOUNT command. 

35.0 
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RES SNA Configuration 


System/36 Host Host 

CNFIGICF Configuration Default 

Generation Parameter Description _ Display _ Entry _ Value 

The password parameter is optional and, if used, must 35.0 
be separated from the userid by a slash (/) and must 
match the value specified in the ADD command (for 
the RTAM generation) for the associated userid. The 

value is 1 through 8 alphameric characters. _ 

The TERM parameter identifies the RJE work station 35.0 
and must match the value specified for System/36 in 
the TERMID parameter of the TERMINAL macro for 

the RTAM generation at the host system. _ 

FIT’3’.The PROC parameter allows you to specify a 35.0 
cataloged procedure at the host system that is to be 

executed as a part of the logon process. _ 

NOTICES/NONOTICE allows you to specify whether 35.0 
all general notices from RES are to be listed at 
System/36 after logon. NOTICES, the default, 
specifies that notices will be listed; NONOTICES 

specifies that notices are not to be listed. _ 

MAIL/NOMAIL allows you to specify whether 35.0 

messages directed to System/3 6 are to be automatically 
listed after logon. MAIL, the default, specifies that 
messages are to be listed. NOMAIL specifies that 

messages are not to be automatically listed. _ 

The value specified for the RDRS parameter of the 37.0 1 

TERMINAL macro for the RTAM stage 1 generation 

at the host system. The value specified for Maximum 

number of host readers on display 37.0 during 

subsystem member configuration at System/3 6 must be 

less than or equal to this value. _ 

The value specified for the PTRS parameter of the 36.0 1 

TERMINAL macro for the RTAM stage 1 generation. 

The value specified for Maximum number of printers on 
display 36.0 during subsystem member configuration at 

System/36 must be at least as large as this value. _ 

The value specified for the PCHS parameter of the 36.0 1 

TERMINAL macro for the RTAM stage 1 generation. 

The value specified for Maximum number of punches on 
display 36.0 during subsystem member configuration at 

System/36 must be at least as large as this value.__ 
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SNA 

SYSTEM/36 MULTIPLE SESSION REMOTE JOB ENTRY 
VSE/POWER HOST SUBSYSTEM WORK SHEET 


VSE/POWER SNA LOGON 

Enter the text to be used as the LOGON command that the VSE/POWER host 
subsystem is expecting from System/36. The value specified on display 35.0 
during subsystem member configuration as System/3 6 must match the value 
expected by VSE/POWER. 

12 3 4 

1 0 0 0 0 

4 5 6 7 8 

1 0 0 0 0 


VSE/POWER uses the following LOGON command format: 

LOGON APPLID(POWER)[LOGMODE(modename)][DATA('remid[,password][,user information]')] 


Generation Parameter Description 

System/36 

CNFIGICF 

Display 

Host 

Configuration 

Entry 

Host 

Default 

Value 

The value for the APPLID parameter is normally 
specified as POWER. 

35.0 


POWER 

The value entered for the LOGMODE parameter, if 
used, specifies the name of an entry in a table at the 
host system that contains the operating parameters for 
SNA communications. The table that contains the 
entry specified is selected by the MODETAB 
parameter of the PU macro during NCP/VTAM 
generation at the host system. The table itself is 
defined using the MODEENT macro. 

35.0 



The values entered for the DATA parameter. 




The remid parameter identifies the remote ID assigned 
to System/36 during VSE/POWER generation at the 
host system. It must match the value specified for the 
REMOTE parameter in the PRMT statement during 
VSE/POWER generation. 

35.0 



The password parameter, if used, is 1 through 8 
alphameric characters and must match the value 
specified for the PSWRD subparameter of the PRMT 
statement. 

35.0 



The user information, if used, can be up to 16 bytes of 
data. Ask the host system personnel whether this 
information is needed. 

35.0 
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VSE/POWER SNA Configuration 


Generation Parameter Description 

System/36 

CNFIGICF 

Display 

Host 

Configuration 

Entry 

Host 

Default 

Value 

VSE/POWER supports one reader only. Specify 1 for 
the Maximum number of host readers on display 37.0 
during subsystem member configuration at System/36. 

37.0 

i 


VSE/POWER supports up to 3 printers. If your 
application generates print output that is returned to 
System/36, specify 1, 2, or 3; otherwise, specify 0. 

The value specified for Maximum number of printers on 
display 36.0 during subsystem member configuration at 
System/36 must be at least as large as this value. 

36.0 



VSE/POWER supports 0 or 1 punches. If your 
application generates punch output that is returned to 
System/36, specify 1; otherwise, specify 0. The value 
specified for Maximum number of punches on display 

36.0 during subsystem member configuration at 
System/36 must be at least as large as this value. 

36.0 
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Appendix B. System/36 SNA MSRJE Bind Command Format 


VTAM is responsible for sending the bind command to System/36. Receipt of a 
correctly formatted bind command is required before MSRJE can be successfully 
started. 

Note: If System/36 rejects the received bind command, you should contact the host 
personnel to verify the contents of the entire bind command. This is necessary 
because when System/36 detects an invalid byte in the bind command, it 
rejects that bind command and performs no further checking. Therefore, even 
if you correct the detected invalid byte, any remaining invalid bytes will cause 
further rejections of the bind command. 

The bind command received by System/36 must contain the following entries: 


Byte 

(Decimal) 

Recommended 

Hex 

Value 

MODETAB 

Operand 

Name 

2 

03 

FMPROF 

3 

03 

TSPROF 

4 

A1 or A3 1 

PRIPROT 

5 

A1 or A3 1 

SECPROT 

6,7 

7080 

COMPROT 

10,11 

8585 

RUSIZES 

14-25 


PSERVIC 

14 

01 

PSERVIC, 
byte 1 


Meaning 

Function management (FM) profile. 

Transmission services (TS) profile. 

Primary logical unit profile. 

Secondary logical unit profile. 

Common protocol. Hex 7080 specifies that function 
management headers are used, brackets are used, bracket 
termination rule 1 is used, and alternate code is used. 

Request/response unit size. Hex 8585 
bytes, as required by MSRJE. 

Presentation services (PS) profile (12 bytes). 

Hex 01 specifies logical unit presentation services 
profile 1. 


specifies/256 \ 

1 1 mi. 


Specify A3 if you want compression. 
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Recommended MODETAB 

Byte Hex Operand 

(Decimal) Value Name Meaning 



PSERVIC, Hex 10 specifies function management header subset 1. 

byte 2 



PSERVIC, Specifies the primary function management header subset 

bytes 3 and 4 flags. Hex 2000 specifies that PDIRs should be sent. 


18 

FI 

PSERVIC, 
byte 5 

Primary data stream subset flags. Hex FI specifies 
interactive data stream, horizontal format data stream, 
vertical tab data stream, vertical select data stream, and 
transparency data stream. 

19 

00 

PSERVIC, 
byte 6 

Not used. Specify hex 00. 

20 

CO 

PSERVIC, 
byte 7 

Primary media flags. Hex CO specifies document output 
and card format. 

21,22 'j) 

0000 

PSERVIC, 
bytes 8 and 9 

Specifies the secondary function management header 
subset flags. Specify 0000. 

23 

01 

PSERVIC, 
byte 10 

Secondary data stream subset flags. Specify hex 01 for 
transparency data stream. 

24 

00 

PSERVIC, 
byte 11 

Not used. Specify hex 00. 

25 

40 

PSERVIC, 
byte 12 

Specifies the secondary media flags. Specify hex 40 for 
card format. 


For a complete description of the bind command format, see the VTAM System 
Programmer's Guide. 
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Appendix C. MSRJE Examples 


Two examples of MSRJE are provided in this appendix. Included for each are the 
configuration displays (from the CNFIGICF procedure), the MSRJE utility control 
statements, and the host system JCL sent by MSRJE to the host system. 

The definition of the forms control table is also shown. The same table is used for 
both examples. 


System/36 MSRJE to RES (BSC) 


This example illustrates using System/36 MSRJE to communicate with a BSC host 
system that is running RES under OS/VS1. Communications will occur over a 
nonswitched communications line. 


| Line Member Configuration 

| The following displays show the attributes specified for the BSC line member, 

| which is named REBSCL1 and is in library RJELIB. 



The name (REBSCL1) entered for prompt 1 is referenced on display 20.0 during 
subsystem member configuration. 
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2.0 


SSP-ICF CONFIGURATION MEMBER TYPE 


REBSCL1 


1. Select the member type from the following options: 

1. INTRA 

2. BSC line member 

3. BSC subsystem member 

4. SNA/SDLC line member 

5. SNA subsystem member 

6. SNA/X.25 line member 

Option.1-6 2 


^^Cmd3-Previous display Cmdl9-Cancel 
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10.0 


BSC LINE MEMBER ATTRIBUTES 


REBSCL1 


W1 


1. Line type.2 

2-Nonswitched pt-pt 3-Switched pt-pt 

2. Error retry count . 1-255 


L Cmdl9-Cancel 

__ J 
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r 


11.0 


REMOTE SYSTEM ATTRIBUTES 
Remote system NBSRES 


REBSCL1 



2. Buffer length 


200-4096 1880 


Cmd7-End Cmdl9-Cancel 





The name (NBSRES) entered for prompt 1 is referenced during subsystem member 
configuration on display 29.0. 

The value (1880) entered for prompt 3 must match the value specified at the host 
system for the TPBFSIZ parameter of the RTAM macro during RTAM stage 1 
generation. 

Subsystem Member Configuration 

The following displays show the attributes specified for the BSC subsystem 
member, which is named REBSCS1 and is in library RJELIB. 



SSP-ICF CONFIGURATION MEMBER DEFINITION 



1. Configuration member name . REBSCS1 

2. Library name.RJELIB 


3. Select one of the following: 

1. Create new member 

2. Edit existing member 

3. Create new member from existing member 

4. Remove a member 

5. Review a member 

Option.$.1-5 1 


Cmd7-End Cmdl9-Cancel 


J 


Note that the library specified for prompt 2 must be the same library in which the 
associated line member (REBSCL1) is stored. 
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2.0 


SSP-ICF CONFIGURATION MEMBER TYPE 


REBSCS1 


W1 


1. Select the member type from the following options: 

1. INTRA 

2. BSC line member 

3. BSC subsystem member 

4. SNA/SDLC line member 

5. SNA subsystem member 

6. SNA/X.25 line member 

Option.1-6 3 


Cmd3-Previous display 



Cmdl9-Cancel 




20.0 


BSC SUBSYSTEM MEMBER SELECTION 


REBSCS1 


1. Line member name.REBSCL1 

2. Select subsystem type from the following options: 

1. BSC CCP 

2. BSC CICS 

3. BSCEL 

4. BSC IMS/IRSS 

5. BSC 3270 

6. BSC MSRJE 

Option.1-6 6 


Cmd3-Previous display 


Cmdl9-Cancel 






The line member name was specified on display 1.0 during line member 
configuration. 
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The remote system in the line member is NBSRES, as specified on display 11.0 
during line member configuration. 



The value (NBSRES) is carried over from display 29.0, and was originally defined 
on display 11.0 during line member configuration. The location name (LOCI) is 
the value used in the MSRJE procedure command to start a session with this 
location. 
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34.0 


MSRJE SUBSYSTEM MEMBER ATTRIBUTES 


Remote system NBSRES Remote location LOCI 


REBSCS1 



1. Host name.RES 

2. Termination delay in minutes . 0-99,blank 

3. Priority . H,M,N,L N 


6. Display informational messages? 


Y,N Y 


Cmdl9-Cancel 





The value (MRJEPROC) specified for the PROC parameter of the LOGON 
command identifies a procedure at the host system that is to be started when 
System/36 logs on to the host system. The procedure is stored in SYS1.PROCLIB. 
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The forms control table (FCT) is described under “Creating the Forms Control 
Table” later in this appendix. Note that the forms control table specified here must 
be created before this subsystem member is used for MSRJE. 


I 


I 
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Running MSRJE 


The following procedure command is used at System/36 to specify communications 
line 1 as being a nonswitched line: 

ALTERCOM 1,NONSWTCH 

The ENABLE command is used to start the subsystem and location on line 1. The 
subsystem name is REBSCS1, as defined on display 1.0 during subsystem member 
configuration. There is only one location (LOCI) in the subsystem member, and it 
is specified as being activated when the subsystem is enabled. 

ENABLE REBSCS1,RJELIB,1 

The MSRJE procedure command is entered to start MSRJE and to start the 
MSRJE console. Note that the location name (LOCI) is as defined on display 
30.0 during MSRJE subsystem configuration. 

MSRJE LOCI,,,,,,CONSOLE 

A second MSRJE procedure command is entered from another display station to 
start an MSRJE reader and to send a procedure member (REDGPRT) to the host 
system. Once the reader is started, the display station is released. Note that the 
library used is the current library, REDGPRT is a procedure member (the default 
specified for type on display 37.0 during MSRJE subsystem member configuration 
is P), and the member does not contain MSRJE utility control statements (the 
default for the CMD parameter is N, as specified on display 37.0 during subsystem 
member configuration). 

Print output is returned from the host system after the member has been sent. 
MSRJE LOCI,REDGPRT,,,,,RELEASE 

A third MSRJE procedure command is entered to start an MSRJE reader and to 
send a procedure member (REDGPUN) to the host system. Once the reader is 
started, the display station is released. Note that the library used is the current 
library, REDGPUN is a procedure member (the default specified for type on 
display 37.0 during MSRJE subsystem member configuration is P), and the 
member does not contain MSRJE utility control statements (the default for the 
CMD parameter is N, as specified on display 37.0 during subsystem member 
configuration). 

Punch output is returned from the host system after the member has been sent. 

MSRJE LOCI,REDGPUN,,,,,RELEASE 

After MSRJE processes the punch data, procedure TEST1 in library RJELIB is 
started. You specify this procedure and library when updating the punch entry, 
FU1, in the forms control table. TEST1 contains a LISTFILE procedure that lists 
the contents of the file you just created: 

LISTFILE ?2?,?1? 
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The following is the data that is sent to the host system when procedure member 
REDGPRT is read by MSRJE. 

//REDGPRT JOB ,Z 

//SI EXEC PGM=IEBDG,PARM='LINECNT=9999' 

//SYSPRINT DD SYSOUT=A 

//SYSOUT1 DD SYSOUT=(A,,FR1),DCB=(LRECL=133,BLKSIZE=133, 
RECFM=FBA) 

//SYSIN DD * 

DSD OUTPUT=(SYSOUT1) 

FD NAME=FIELD1,LENGTH=50,STARTLOC=1,PICTURE=50, 

'0100 RECORDS OF RJE PRINTER OUTPUT - ' 

FD NAME=FIELD2,LENGTH=51,STARTLOC=51,PICTURE=51, 

'SPECIAL FORM = FR1 -THIS IS RECORD NUMBER ’ 

FD NAME=FIELD3,LENGTH=04,STARTLOC=102,FORMAT=ZD, 

INDEX=1 

CREATE QUANTITY=0100,NAME=(FIELD1,FIELD2,FIELD3) 

END 

/* 

// 

The fourth record in the member 

//SYSOUT1 DD SYSOUT=(A,,FR1),DCB=(LRECL=133,BLKSIZE=133, 
RECFM=FBA) 

specifies the forms name that will be returned to System/36 (FR1). The forms 
control table (FCT) specified on display 36.0 during subsystem member 
configuration is searched for an entry name FR1 when the output is returned. 
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The following is the data that is sent to the host system when procedure member 
REDGPUN is read by MSRJE. 

//REDGPUN JOB ,Z 
//SI EXEC PGM=IEBDG 
//SYSPRINT DD SYSOUT=A 

//SYSOUT1 DD SYSOUT=(B,,FU1),DCB=(LRECL=80,BLKSIZE=80, 
RECFM=FB) 

//SYSIN DD * 

DSD OUTPUT=(SYSOUT1) 

FD NAME=FIELD1,LENGTH=35,STARTLOC=1,PICTURE=35, 

'0100 RECORDS OF PUNCH OUTPUT — SPE' 

FD NAME=FIELD2,LENGTH=41,STARTLOC=36,PICTURE=41, 

' CIAL FORM = FU1 — THIS IS RECORD NUMBER ' 

FD NAME=FIELD3 , LENGTH=04, STARTLOC=77 , FORMAT=ZD, 
INDEX=1 

CREATE QUANTITY=0100,NAME=(FIELD1,FIELD2,FIELD3) 

END 

/* 

// 

The fourth record in the member 

//SYSOUT1 DD SYSOUT=(B,,FU1),DCB=(LRECL=80,BLKSIZE=80, 
RECFM=FBA) 

specifies the forms name that will be returned to System/36 (FU1). The forms 
control table (FCT) specified on display 36.0 during subsystem member 
configuration is searched for an entry named FUl when the output is returned. 

The following is the procedure (MRJEPROC) at the host system (in 
SYS1.PROCLIB) that is executed when System/36 logs on to the host system. 

This is the same procedure as specified for the PROC parameter in the LOGON 
command on display 34.0 during subsystem member configuration. 

// 

SF ,RD1 
SF ,RD2 
SF ,RD3 
SF ,PU1 
SF ,PR1 
MN JOBNAMES,T 

Note that host readers RD2 and RD3 are not used by MSRJE because display 37.0 
specifies one host reader. 
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I System/36 MSRJE to RES (SNA) 


This example illustrates using System/36 MSRJE to communicate with a SNA host 
system that is running RES under OS/VS1. Communications will occur over a 
nonswitched communications line. 


| Line Member Configuration 

| The following displays show the attributes specified for the SNA line member, 

| which is named RESNAL1 and is in library RJELIB. 

| Note: See the System Reference manual for an example of an SNA/X.25 line 

| member configuration. 



| The name (RESNAL1) entered for prompt 1 is referenced on display 21.0 during 

| subsystem member configuration. 
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2.0 


SSP-ICF CONFIGURATION MEMBER TYPE 


RESNAL1 


1. Select the member type from the following options: 

1. INTRA 

2. BSC line member 

3. BSC subsystem member 

4. SNA/SDLC line member 

5. SNA subsystem member 

6. SNA/X.25 line member 


Cmd3-Previous display 


Cmdl9-Cancel 


SSP-ICF CONFIGURATION MEMBER TYPE 


1. Select the member type from the following options: 

1. INTRA 

2. BSC line member 

3. BSC subsystem member 

4. SNA/SDLC line member 

5. SNA subsystem member 

6. SNA/X.25 line member 


Option 


3. Will APPC be used ? 


Cmd3-Previous display 


Cmdl9-Cancel 
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12.0 

1. Data link protocol 
1-Primary 


2. Line type 
1-Nonswitched 


SNA LINE MEMBER ATTRIBUTES 
2-Secondary 
2-Switched 


RESNAL1 W1 
2 

1 


Cmdl9-Cancel 




12.0 SNA LINE MEMBER ATTRIBUTES RESNAL1 W1 

1 . Data link protocol.2 

1-Primary 2-Secondary 

2. Line type .1 

1-Nonswitched 2-Switched 


5. Local system's station address . 01-FE 

6. Local system's station XID in hexadecimal . . . 


Cl L \ 

00FC1 ^ 


Cmdl9-Cancel 
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REMOTE SYSTEM SELECTION 

RESNAL1 W1 1 

! 1. Select from the following options: 

1-Create 


Option . 

2. Remote system name . . 


.1 

.RES ,• - 

OPTION REMOTE SYSTEM 

OPTION REMOTE SYSTEM 

OPTION REMOTE SYSTEM 

Cmd8-Reset 

V._ 

Cmdl9-Cancel 

_ ) 


13.0 REMOTE SYSTEM ATTRIBUTES 

Remote system RES 

1. Remote system type . 

1-Host 2-Peer 


RESNAL1 W1 


Cmdl9-Cancel 


The name (RES) entered for prompt 1 is referenced during subsystem member 
configuration on display 29.0. 
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After the Enter key is pressed, another prompt is added to display 13.0: 



Display 14.0 defines the logical unit sessions that are to be used by MSRJE. 
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Subsystem Member Configuration 


The following displays show the attributes specified for the SNA subsystem 
member, which is named RESNAS1 and is in library RJELIB. 



0 SSP-ICF CONFIGURATION MEMBER DEFINITION 



1. Configuration member name . RESNAS1 

2. Library name.RJELIB 


3. Select one of the following: 

1. Create new member 

2. Edit existing member 

3. Create new member from existing member 

4. Remove a member 

5. Review a member 

Option.1-5 1 


Cmd7-End Cmdl9-Cancel 




Note that the library specified for prompt 2 must be the same library in which the 
associated line member (RESNAL1) is stored. 
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2.0 SSP-ICF CONFIGURATION MEMBER TYPE RESNAS1 

1. Select the member type from the following options: 

1. INTRA 

2. BSC line member 

3. BSC subsystem member 

4. SNA/SDLC line member 

5. SNA subsystem member 

6. SNA/X.25 line member 

Option.1-6 5 


rr~ 



SNA SUBSYSTEM MEMBER SELECTION 


RESNAS1 


1. Line member name.RESNAL1 

2. Select subsystem type from the following options: 

1. Peer 

2. SNA Upline 

3. SNA 3270 

4. Finance 

5. SNA MSRJE 

6. APPC 

Option.1-6 5 


Cmd3-Previous display 


Cmdl9-Cancel 




The line member name was specified on display 1.0 during line member 
configuration. 
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The remote system in the line member is RES, as specified on display 11.0 during 
line member configuration. 



| The value (RES) is carried over from display 29.0, and was originally defined on 

| display 11.0 during line member configuration. The location name (LOCI) is the 

value used in the MSRJE procedure command to start a session with this location. 
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34.0 


MSRJE SUBSYSTEM MEMBER ATTRIBUTES 


RESNAS1 


W1 


I 

I 


Remote system RES Remote location LOCI 


1. Host name.. 

2. Termination delay in minutes . 0-99,blank 

3. Priority . H,M,N,L 

4. Maximum number of sessions.1-46 

5. Minimum number of sessions . 1-46 

6. Display informational messages?.. / . . Y,N 


Cmd19-Cancel 

V 


FSCPROC 


H 

32 ij- 

01 

Y 









The value (FSPROC) specified for the PROC parameter of the LOGON command 
identifies a procedure at the host system that is to be started when System/36 logs 
on to the host system. The procedure is stored in SYS1.PROCLIB. 
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36.0 


MSRJE PRINTER/PUNCH ATTRIBUTES 


RESNAS1 



Remote system RES 


Remote location LOCI 


1 . Forms control table name.FCT 

2. Forms set.0-8 1 

3. Maximum number of printers.0-15 01 

4. Printer file sequence number. 1-99 01 

5. Maximum number of punches.0-15 01 

6. Punch file sequence number. 1-99 01 


Cmdl9-Cancel 


v. 




The forms control table (FCT) is described under “Creating the Forms Control 
Table” later in this appendix. Note that the forms control table specified here must 
be created before this subsystem member is used for MSRJE. 
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Running MSRJE 


The following procedure command is used at System/36 to specify communications 
line 1 as being a nonswitched line: 

ALTERCOM 1,NONSWTCH 

The ENABLE command is used to start the subsystem and location on line 1. The 
subsystem name is RESNAS1, as defined on display 1.0 during subsystem member 
configuration. There is only one location (LOCI) in the subsystem member, and it 
is specified as being activated when the subsystem is enabled. 

ENABLE RESNAS1,RJELIB,1 

The MSRJE procedure command is entered to start MSRJE and to start the 
MSRJE console. Note that the location name (LOCI) is as defined on display 
30.0 during MSRJE subsystem configuration. 

MSRJE LOCI,,,,,,CONSOLE 

A second MSRJE procedure command is entered from another display station to 
start an MSRJE reader and to send a procedure member (REDGPRT) to the host 
system. Once the reader is started, the display station is released. Note that the 
library used is the current library, REDGPRT is a procedure member (the default 
specified for type on display 37.0 during MSRJE subsystem member configuration 
is P), and the member does not contain MSRJE utility control statements (the 
default for the CMD parameter is N, as specified on display 37.0 during subsystem 
member configuration). 

Print output is returned from the host system after the member has been sent. 
MSRJE LOCI,REDGPRT,,,,,RELEASE 

A third MSRJE procedure command is entered to start an MSRJE reader and to 
send a procedure member (REDGPUN) to the host system. Once the reader is 
started, the display station is released. Note that the library used is the current 
library, REDGPUN is a procedure member (the default specified for type on 
display 37.0 during MSRJE subsystem member configuration is P), and the 
member does not contain MSRJE utility control statements (the default for the 
CMD parameter is N, as specified on display 37.0 during subsystem member 
configuration). 

Punch output is returned from the host system after the member has been sent. 
MSRJE LOCI,REDGPUN,,,,,RELEASE 

After MSRJE processes the punch data, procedure TEST1 in library RJELIB is 
started. You specify this procedure and library when updating the punch entry, 
FU1, in the forms control table. TEST1 contains a LISTFILE procedure that lists 
the contents of the file you just created: 

LISTFILE ?2?,?1? 
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The following is the data that is sent to the host system when procedure member 
REDGPRT is read by MSRJE. 

//REDGPRT JOB ,Z 

//SI EXEC PGM=IEBDG,PARM='LINECNT=9999' 

//SYSPRINT DD SYSOUT=A 

//SYSOUT1 DD SYSOUT=(A,,FR1),DCB=(LRECL=133,BLKSIZE=133, 
RECFM=FBA) 

//SYSIN DD * 

'DSD OUTPUT=(SYSOUT1) 

FD NAME=FIELD1 , LENGTH=50, STARTLOC=1 , PICTURE=50, 

’0100 RECORDS OF RJE PRINTER OUTPUT - ’ 

FD NAME=FIELD2,LENGTH=51,STARTLOC=51,PICTURE=51, 

. 'SPECIAL FORM = FR1 -THIS IS RECORD NUMBER ' 

FD NAME=FIELD3,LENGTH=04,STARTLOC=102,FORMAT=ZD, 

INDEX=1 

CREATE QUANTITY=0100,NAME=(FIELD1,FIELD2,FIELD3) 

END 

/* 

// 


The fourth record in the member 

//SYSOUT1 DD SYSOUT=(A,,FR1),DCB=(LRECL=133,BLKSIZE=133, 
RECFM=FBA) 

specifies the forms name that will be returned to System/36 (FR1). The forms 
control table (FCT) specified on display 36.0 during subsystem member 
configuration is searched for an entry name FR1 when the output is returned. 


The following is the data that is sent to the host system when procedure member 
REDGPUN is read by MSRJE. 

//REDGPUN JOB ,Z 
//SI EXEC PGM=IEBDG 
//SYSPRINT DD SYSOUT=A 

//SYSOUT1 DD SYSOUT=(B,,FU1),DCB=(LRECL=80,BLKSIZE=80, 
RECFM=FB) 

//SYSIN DD * 

DSD OUTPUT=(SYSOUT1) 

FD NAME=FIELD1,LENGTH=3 5,STARTLOC=1,PICTURE=35, 
'0100 RECORDS OF PUNCH OUTPUT — SPE' 

FD NAME=FIELD2,LENGTH=41,STARTLOC=36,PICTURE=41, 

'CIAL FORM = FU1 — THIS IS RECORD NUMBER ' 

FD NAME=FIELD3,LENGTH=04,STARTLOC=77,FORMAT=ZD, 
INDEX=1 

CREATE QUANTITY=0100,NAME=(FIELD1,FIELD2,FIELD3) 

END 

/* 

// 

The fourth record in the member ..... j 

//SYSOUT1 DD SYSOUT=(B,,^V1) /DCB=(LRECL=80,BLKSIZE=80, 
RECFM=FBA) ~ 

specifies the forms name that will be returned to System/36 (FU1). The forms 
control table (FCT) specified on display 36.0 during subsystem member 
configuration is searched for an entry named FU1 when the output is returned. 
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The following is the procedure (FSPROC) at the host system (in SYS1.PROCLIB) 
that is executed when System/36 logs on to the host system. This is the same 
procedure as specified for the PROC parameter in the LOGON command on 
display 34.0 during subsystem member configuration. 

// 

SF ,RD1 
SF ,PR1 
MN JOBNAMES,T 

Note that the host punch (PU1) is not started by this procedure. It must be started 
by the RJE operator before punch output can be received. 
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Creating the Forms Control Table 


The control table created here is used to control the destination of output received 
from the host system. It is named FCT and is used in both the BSC and SNA 
examples. 


r 


MSRJE CONTROL TABLE UTILITY 
Work with control tables 


Select one of the following: 

1. Create a new table 

2. Update entries in an existing table 

3. Add entries to an existing table 

4. Remove entries from an existing table 

5. Remove a table 

6. Print entries from an existing table 

7. Print a table 

8. Review entries in an existing table 

9. End the control table utility 

Option . 


Optional-* 


1 


Table name 


FCT 


Preferred disk location . A1,A2,A3,A4,block number A1 * 

Cmd7-End of job Cmd2-Page back 

(c) 1985 IBM Corp. 


v. 




The name of the table (FCT) is referenced by prompt 1 on display 36.0 during 
subsystem member configuration. 



The entry name matches the host forms name used for print output in the BSC and 
SNA examples. 
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MSRJE CONTROL TABLE UTILITY 


FCT 

FR1 


Create an MSRJE forms control table print entry 


Optional-* 

Local forms name.LFP1 * 

Printer ID or SYSTEM . SYSTEM 

Align the forms before printing? . N, Y N 

Spool?.Y,N Y 

Final quality printing?...N, Y N 

Issue end of forms message?.Y,N Y 

Select a printwheel ID for the printer?.N, Y N 


Cmd3-Save entry, display entry menu Cmd7-End of job, cancel entry 

(c) 1985 IBM Corp. 





MSRJE CONTROL TABLE UTILITY 


FCT 

FR1 


Create an MSRJE forms control table print entry 


Optional-* 

Lines per inch.4,6,8 * 

Characters per inch.10,15 * 

Lines per page. 1-112 68 * 

Line number of the last line per page. 1-112 68 * 

Line skips for forms: 

01-1 02-0 03-0 04-0 

05-0 06-0 07-0 08-0 

09-0 10-0 11-0 12-0 


L Cmd3-Save entry, display entry menu Cmd7-End of job, cancel entry 

(c) 1983 IBM Corp 
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MSRJE CONTROL TABLE UTILITY 


FCT 

FR1 


Create an MSRJE forms control table print entry 


Optional-* 

Hold in the spool file after printing?.N,Y N 

Begin printing when the job step ends?.Y,N Y 

Continue printing the same job stream?.N,Y N 

Number of copies to be printed. 1-255 1 * 

Priority on the spool file.0-5 1 

Expected activity of spooled print file . N,H,L,M N 


Cmd3-Save entry, display entry menu Cmd7-End of job, cancel entry 



Update the compressed disk file information? . N,Y, N 


Cmd3-Save entry, display entry menu Cmd7-End of job, cancel entry 
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MSRJE CONTROL TABLE UTILITY 


FCT 


Create a control table entry 


Select a type of entry to work with: 

1. Print 

2. Print default 

3. Punch 

4. Punch default 

Option . 3 

Select where the output is to go: 

1. Printer 

2. Disk file 

3. Compressed disk file 

Option . 2 

Table entry name.FU1 

Cmd3-Save table, display table menu Cmd7-Save table, end of job 

(c) 1983 IBM Corp. 


The table entry name (FU1) matches the host forms name that will be sent by the 
host system with punch data for both examples. 


MSRJE CONTROL TABLE UTILITY FCT 

FU1 

Create an MSRJE forms control table punch entry 

Optional-* 

Name of the file to be created.LFU1 

User ID.HOST 

Procedure name . TEST1 * 

Library name.RJELIB 

Type of file to be created.S,D,I S 

Save the file in case of error?.Y,N Y 

Add output to an existing file?.N,Y N 

Free unused file blocks?.Y,N Y 

Cmd3-Save entry, display entry menu Cmd7-End of job, cancel entry 

(c) 1983 IBM Corp. 
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MSRJE CONTROL TABLE UTILITY 


FCT 

FU1 
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Appendix D. Forms Control Table Default Entries 


Whenever you create an MSRJE forms control table, the forms control utility 
automatically places two entries in the table. One of these entries is used for print 
output when no entry in the table matches the received host forms name, and the 
other entry is used for punch output received when no entry in the table matches 
the received host forms name. 

If you do not specify a forms control table on display 36.0 during subsystem 
member configuration, the IBM-supplied values for print and punch default entries 
are used. As supplied, the default print entry causes received printer data to be 
printed; received punch data is written to a disk file. 


IBM-Supplied Print and Punch Default Values 


IBM-Supplied Print Default Entry 

The following displays show the values used for the IBM-supplied print default 
entry. The received print data is printed. 



MSRJE CONTROL TABLE UTILITY 
Update a control table entry 


Select a type of entry to work with: 

1. Print 

2. Print default 

3. Punch 

4. Punch default 

Option . 

Select where the output is to go: 

1. Printer 

2. Disk file 

3. Compressed disk file 

Option . 

Table entry name . 


FORMFILE 



2 


1 


Cmd3-Save table, display table menu 



Cmd7-Save table, end of job 

(c) 1983 IBM Corp. 

_ J 
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MSRJE CONTROL TABLE UTILITY 


FORMFILE 


Update an MSRJE forms control table print entry 


Optional-* 

Local forms name. * 

Printer ID or SYSTEM . SYSTEM 

Align the forms before printing?.N,Y N 

Spool?.Y,N Y 

Final quality printing? . N,Y N 

Issue end of forms message?.Y,N Y 

Select a printwheel ID for the printer?.N,Y N 


L Cmd3-Save entry, display entry menu Cmd7-End of job, cancel entry 

(c) 1985 IBM Corp. 
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MSRJE CONTROL TABLE UTILITY 


FORMFILE 


Update an MSRJE forms control table print entry 


Optional-* 

Hold in the spool file after printing?.N, Y N 

Begin printing when the job step ends?.Y ,N Y 

Continue printing the same job stream?.N,Y N 

Number of copies to be printed . 1-255 * 

Priority on the spool file.0-5 1 

Expected activity of spooled print file . N,H,L,M N 


Cmd3-Save entry, display entry menu Cmd7-End of job, cancel entry 



MSRJE CONTROL TABLE UTILITY 
Update a control table entry 

Update the compressed disk file information? . N,Y N 


Cmd3-Save entry, display entry menu Cmd7-End of job, cancel entry 
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IBM-Supplied Punch Default Entry 


The following displays show the values used for the IBM-supplied punch default 
entry. The received punch data is written to a disk file. 



MSRJE CONTROL TABLE UTILITY 
Update a control table entry 


Select a type of entry to work with: 

1. Print 

2. Print default 

3. Punch 

4. Punch default 

Option . 

Select where the output is to go: 

1. Printer 

2. Disk file 

3. Compressed disk file 

Option . 

Table entry name . 


FORMFILE 




4 


2 


Cmd3-Save table, display table menu 


Cmd7-Save table, end of job 

(c) 1983 IBM Corp. 




MSRJE CONTROL TABLE UTILITY 
Update an MSRJE forms control table punch entry 


FORMFILE 

Optional-* 




Name of the file to be created . . , 

User ID.. 

Procedure name.. 

Library name . 

Type of file to be created .... 
Save the file in case of error? 

Add output to an existing file? 

Free unused file blocks? . 

Cmd3-Save entry, display entry menu 



MSRJE 

MSRJE 


. #LIBRARY 

. S,D,I S 

.Y,N Y 

.N, Y N 

.Y, N Y 

Cmd7-End of job, cancel entry 

(c) 1983 IBM Corp. 
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MSRJE CONTROL TABLE UTILITY 
Update an MSRJE forms control table punch entry 


Number of blocks to be reserved 


Number of blocks to extend the file 


Preferred disk location . A1,A2,A3,A4,block number A1 


Record length in bytes 


Delete capable file?.N, Y N 


Cmd3-Save entry, display entry menu Cmd7-End of job, cancel entry 


(c) 1983 IBM Corp. 
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Changing the Default Entries 


You can change the default entries by using the update entry option (option 2 on 
the Control Table display). The name of a default entry is always 8 blanks. 


Changing the Destination in a Print Default Entry 

The IBM-supplied print default entry directs output to the printer. If you change 
the destination to a file with unprocessed 256-character records, but do not change 
the values within the entry, the following values are used: 



MSRJE CONTROL TABLE UTILITY 
Update a control table entry 


FORMFILE 


Select a type of entry to work with: 

1. Print 

2. Print default 

3. Punch 

4. Punch default 

Option . 2 

Select where the output is to go: 

1. Printer 

2. Disk file 

3. Compressed disk file 

Option . 3 

Table entry name . 


Cmd3-Save table, display table menu Cmd7-Save table, end of job 

(c) 1983 IBM Corp. 

V_ _ J 
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MSRJE CONTROL TABLE UTILITY 

Update an MSRJE forms control table compressed disk file entry 


Optional-* 

Name of the file to be created.MSRJE 

User ID.MSRJE 

Number of blocks to be reserved . 1-312815 60 

Number of blocks to extend the file.0-312815 10 

Preferred disk location . A1,A2,A3,A4,block number A1 * 

Save the file in case of error?.Y,N Y 

Add output to an existing file?.N,Y N 

Free unused file blocks?.Y,N Y 

Cmd3-Save entry, display entry menu Cmd7-End of job, cancel entry 

(c) 1983 IBM Corp. 


' MSRJE CONTROL TABLE UTILITY 


FORMFILE 

Update an MSRJE forms control table print 

entry 

Optional-* 

Local forms name.. 

. . . 

* 

Printer ID or SYSTEM . 

. . . 

SYSTEM 

Align the forms before printing? . 

. N,Y 

N 

Spool? . 

. Y,N 

Y 

Final quality printing? . 

. N,Y 

N 

Issue end of forms message? . 

. Y,N 

Y 

Select a printwheel ID for the printer? . 

. N,Y 

N 

Cmd3-Save entry, display entry menu Cmd7-End of job. 

cancel 

entry 

V 

(c) 

1985 IBM Corp. 

J 
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MSRJE CONTROL TABLE UTILITY 
Update an MSRJE forms control table print entry 

Lines per inch.4,6,8 

Characters per inch.10,15 

Lines per page.1-112 

Line number of the last line per page.1-112 


number 

of 

the last line 

per page 

• * • 

skips 
01 - 

for 

1 

forms: 

02 - 

0 

03 

05 - 

0 

06 - 

0 

07 

09 - 

0 

10 - 

0 

11 


FORMFILE 

Optional-* 


Cmd3-Save entry, save entry menu 


Cmd7-End of job, cancel entry 

(c) 1983 IBM Corp 


a 


MSRJE CONTROL TABLE UTILITY FORMFILE 

Update an MSRJE forms control table print entry 

Optional-* 

Hold in the spool file after printing?.N,Y N 

Begin printing when the job step ends?.Y,N Y 

Continue printing the same job stream?.N,Y N 

Number of copies to be printed . 1-255 * 

Priority on the spool file.0-5 1 

Expected activity of spooled print file . N,H,L,M N 


Cmd3-Save entry, display entry menu Cmd7-End of job, cancel entry 

(c) 1983 IBM Corp 
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Changing the Destination in a Punch Default Entry 


The IBM-supplied print default entry directs output to a disk file. If you change 
the destination to a file with unprocessed 256-character records but do not change 
the values within the entry, the following values are used: 


^ MSRJE CONTROL TABLE UTILITY 


FORMFILE 

Update a control table entry 



Select a type of entry to work with: 

1. Print 

2. Print default 

3. Punch 

4. Punch default 

Option . 


4 

Select where the output is to go: 

1. Printer 

2. Disk file 

3. Compressed disk file 

Option . 


3 

Table entry name . 

. . . . 


Cmd3-Save table, display table menu Cmd7-Save table. 

end of 

job 

V 

(c) 

1983 IBM Corp. 

J 


MSRJE CONTROL TABLE UTILITY 

Update an MSRJE forms control table compressed disk file entry 


Optional-^ 

Name of the file to be created.MSRJE 

User ID.MSRJE 

Number of blocks to be reserved . 1-312815 60 

Number of blocks to extend the file.0-312815 10 

Preferred disk location . A1,A2,A3,A4,block number A1 * 

Save the file in case of error?.Y ,N Y 

Add output to an existing file?.N,Y N 

Free unused file blocks?.Y ,N Y 

Cmd3-Save entry, display entry menu Cmd7-End of job, cancel entry 

(c) 1983 IBM Corp. 
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MSRJE CONTROL TABLE UTILITY 


FORMFILE 


Update an MSRJE forms control table punch entry 

Optional-* 


I Name of the file to be created . . 

User ID . 

Procedure name . 

Library name . 

Type of file to be created .... 
Save the file in case of error? 

Add output to an existing file? 

j Free unused file blocks? . 

Cmd3-Save entry, display entry menu 

L_ 


MSRJE 

MSRJE 


. S ,D, I 

.Y,N 

.N,Y 

.Y,N 

Cmd7-End of job, cancel 
(c) 


#LIBRARY 

S 

Y 
N 

Y 


entry 

1983 IBM Corp. 


MSRJE CONTROL TABLE UTILITY 
Update an MSRJE forms control table punch entry 

Number of blocks to be reserved . 1-312815 

Number of blocks to extend the file.0-312815 

Preferred disk location . A1,A2,A3,A4,block number 

Record length in bytes . 1-4096 

Delete capable file? . N,Y 


FORMFILE 

Optional-* 

60 

10 

A1 * 

80 
N 




L Cmd3-Save entry, display entry menu Cmd7-End of job, cancel entry 

(c) 1983 IBM Corp. 
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Appendix E. Establishing a Communications Link 


The following forms show an example of the procedure that should be followed to 
initiate MSRJE communications on a switched line. The example is for a manual 
answer BSC line (System/36 line number 1). 

The subsystem that is to be used is called BSC and is stored in library 
COMMLIBR. MSRJE uses remote location BSCLOC in the subsystem member. 

In the example, the operator signs on to MSRJE as the console and specifies a disk 
file to be used as reader input. 

It is recommended that these forms (which can be found in the Operating Your 
Computer) be filled out for each communications application that uses a switched 
line. 
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USING MULTIPLE SESSION REMOTE JOB ENTRY 


To Establish the Communications Link 

1. At a display station, perform the following steps: 
Enter ALTERCOM 1,SWITCHED,MA 
Enter ENABLE BSC,COMMLIBR,1 
Enter MSRJE BSCLOC,SENDREC„ 
DISK,,,CONSOLE 


b. SYS-3401 SDLC (line number) Operator 
dial is required . . . 

This message is displayed because you have an 
SDLC switched line, and you must call a remote 
location. Perform the following steps: 


2. At the system console, one of the following messages - 

may be displayed: __ 

a. RJE-4631 Line (line number) Operator c. RJE-4632 Line (line number) Operator 
dial is required . . . answer is required . . . 


This message is displayed because you have a BSC 
switched line, and you must call a remote location. 
Perform the following steps: 


This message is displayed because you have a BSC 
switched line, and you must answer a call from a 
remote location. Perform the following steps: 


Respond to the message with 


option 


When the telephone rinas, answer it. 


Press the data button on the telephone. 



S7909006-0 
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To End the Communications Link 


d. SYS-3400 SDLC (line number) Operator 
answer is required . . . 

This message is displayed because you have an 
SDLC switched line, and you must answer a call 
from a remote location. Perform the following steps: 



e. Other message 

See the System Messages manual for an explanation 
of the message and the steps that you should follow. 

S7909007-0 


Appendix E. Establishing a Communications Link E-3 







E-4 Multiple Session Remote Job Entry Guide 



Appendix F. MSRJE Problem Determination 


This appendix contains a problem determination procedure that can help you find 
the cause of an MSRJE problem. 


MSRJE Problem Determination Procedure 

The following procedure helps you to determine whether the MSRJE feature, 
improper operation, or an incorrect configuration value is causing the problem. 

The procedure either tells you how to correct the problem or tells you who to call 
at the host system for assistance. If a problem continues to occur, the procedure 
directs you to call for service. In most cases, you would be calling for your 
System/36 programming service representative. 

Note: If you correct a problem as requested by the following procedure and another 
problem occurs, go back to step 1 , discard any previously printed displays, and 
go through the procedure again using the new symptom . If the problem cannot 
be corrected by the procedure, you should refer to “Calling for Service” (at the 
end of this appendix), collect the information described there, and then call 
your service representative. 
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1. Are there any System/36 messages (messages preceded by the 4-digit 
identification code) associated with this job? 

These messages can be seen: 

— At your display, 

- At the System/36 system console, or 

- In the System/36 history file. (Use the HISTORY procedure to 
look at the messages that have system console routing.) 


Yes No 

I 

Call and ask the host system operator: Are there any messages at 
the host system associated with this remote job entry? 


Yes No 

I 

Do the following: 

A. Use the D I command and the Print key to display and print 
MSRJE subsystem status. 

B. On the subsystem status display, locate the line number that 

is associated with your subsystem. Then use the D C command 
and the Print key to display and print the communications 
status for the communications line being used by MSRJE (for 
each communications line, there are three display segments). 

You should print the set of displays that is associated 
with the line shown on the D I display for your subsystem. 

C. Your MSRJE subsystem configuration is defined by values 
specified in both a subsystem member and a line member. 

Use the CNFIGICF procedure to display and print all the 
displays for both the subsystem member and line member 
that are being used by this subsystem configuration. 

- The subsystem member name is the first parameter on the 
ENABLE procedure command. Enter this name for prompt 1 
of CNFIGICF display 1.0. Also, enter the right library 
name for prompt 2, and enter a 5 for prompt 3. 

- The location name is the first parameter on the MSRJE 
procedure command. Enter the location name on prompt 2 
of CNFIGICF display 30.0. 

- The line member name is shown on prompt 1 of CNFIGICF 
display 21.0, which is one of the subsystem member displays. 
Enter this name on prompt 1 of CNFIGICF display 1.0, and 
enter the library name for prompt 2 and a 5 for prompt 3. 

(See Chapter 2 for information about the CNFIGICF procedure. 

You will use the above information in most of the following 

problem determination steps. Now go to step 2. 


V V 

(continued on next page) 
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V V 


Correct the problem indicated by the host system message and try 
the job again. If the problem indicated by the host system message 
continues to occur, call your service representative. 

See “Calling for Service” for more information. 

Correct the problem indicated by the message(s) and try the job 
again. Correct the problem using the MSRJE messages manual, the 
System Messages manual, and possibly the System Problem Determination 
manual. 

Were you able to solve the problem using the System/36 messages? 

Yes No 

I 

Call and ask the host system operator: Are there any messages at 
the host system associated with this remote job entry? 

Yes No 

Call your service representative. See “Calling for Service” 
for more information. 

Correct the problem indicated by the host system message and try 
the job again. If the problem indicated by the host system message 
continues to occur, call your service representative. 

See “Calling for Service” for more information. 

End of problem determination. 
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2. Is Startup in progress being displayed continuously (for at 
least 2 minutes)? 

Yes No 

I 

Does it appear that you are having console problems? 

For example, are you unable: to send host system console messages, 
to enter MSRJE console utility control statements, or to display 
host system console messages or MSRJE console messages? 

Yes No 

Does it appear that you are having reader problems? 

For example, is Waiting for a reader, Reader Input, or 
READFILE in progress being displayed continuously (for at 
least 2 minutes)? 

Yes No 

i 

Does it appear that you are having printer or punch 
problems? For example, are you waiting for print or punch 
output, or was the received output handled incorrectly? 

Yes No 

I 

Are you having problems ending MSRJE? 

Yes No 

I 

End of problem determination; call your service 
representative. See “Calling for Service” for more 
information. 

Go to step 12. 

Go to step 10. 

Go to step 9. 

Go to step 6. 

Go to step 3. 


F-4 Multiple Session Remote Job Entry Guide 



3. Are you using a switched line? 


Yes No 

I 

Go to step 4. 

Check display 10.0 (for BSC) or check displays 12.0 and 13.0 (for SNA) 
of the CNFIGICF displays you printed. 

Was autoanswer specified for the switched line? 

Yes No 

I 

Go to step 4. 

The host system or the host system operator must call System/3 6 to 
connect the communications line. Ask the host system operator to call. 

Has the problem been corrected? 

Yes No 

i 

Does the modem support autoanswer? 

Yes No 

I 

If the modem does not support autoanswer, System/36 will not 
answer. Disable the MSRJE subsystem and use CNFIGICF to 
specify manual answer for this line (on display 10.0 for BSC 
or display 12.0 for SNA). Then enable the subsystem to make 
the change effective. 

Go to step 4. 

End of problem determination. 


4, Are you using BSC MSRJE? 

Yes No 

I 

Go to step 5. 

Call the host system operator and make sure that the communications 
line has been started. If the line has been started and the 
problem still occurs, call your service representative. See 
“Calling for Service” for more information. 
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5. Call the host system operator and ask if all of the following are 
active at the host system: 

A. The communications line 

B. The physical unit 

C. All the LUs (logical units) 

Yes No 

I 

Ask the host system operator to vary the line, LU, and/or 
physical unit active. 

Check the following and make any necessary corrections: 

A. The NRZI parameter (found on the first display segment of the ’D H’ 
display for the line you are trying to use) must be specified with 

the same value that was specified on the LINE macro in the host 
system’s VTAM/NCP generation. If the value is not the same, use 
the SETCOMM procedure to change the NRZI parameter to match the 
value specified at the host system. 

B. The local system’s station address specified during CNFIGICF 
(on display 13.0, prompt 5) must be the same as the address 
specified for the ADDR parameter on the PU macro in the host 
system’s VTAM/NCP generation. 

C. The LU (logical unit) assignments entered during CNFIGICF (on 
display 14.0) must be the same as those assigned during the host 
system’s VTAM/NCP generation. 

D. The number of LUs assigned for SNA MSRJE (that is, the number of Cs 
specified on display 14.0 of the line member being used for MSRJE) 
must be at least as large as the maximum number of sessions 

specified on display 34.0, prompt 4 for the MSRJE subsystem member 
being used. 

E. The minimum number of sessions specified during CNFIGICF (on 
display 34.0, prompt 5) must be varied active at the host system. 


Note: If you need to change a value for your MSRJE subsystem, you 

should disable the subsystem, make the required change(s), and then 
enable the subsystem to make the change effective. 

(continued on next page) 
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Were any corrections made to the items above? 


Yes No 

I 

If no changes were made to the items, either in your subsystem’s 
configuration or at the host system, call your service 
representative. See “Calling for Service” for more information. 

If the problem still occurs after you have made the corrections, you should 
return to step 1, discard any previously printed displays, and start again. 

Are you unable to send host system console messages, or are you 
unable to enter MSRJE console utility control statements? 

Yes No 

Are you unable to display host system console messages? 

Yes No 

I 

Are you unable to display MSRJE console messages? 

Yes No 

I 

End of problem determination; call your service 
representative. See “Calling for Service” for more 
information. 

Did you specify CONSOLE on the MSRJE procedure command? 
Yes Ijjfo 

You must specify CONSOLE to display MSRJE console 
messages; the console messages are in the history file. 

Call your service representative. See “Calling for Service” 
for more information. 

Go to step 8. 

Go to step 7. 
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7. Did you specify CONSOLE on the MSRJE procedure command? 

Yes No 

I 

You must specify CONSOLE to send console messages to the host 
system or to enter MSRJE console utility control statements. 

Press command key 7 to end this job. Reenter the MSRJE 
procedure command, specifying CONSOLE. 

Is Console Input displayed on line 21? 

Yes No 

Press command key 1 to make Console Input appear on line 21 
of the display. Then you should be able to send host system console 
messages or enter MSRJE console utility control statements. 

Is the input inhibit indicator on continuously (for at least 2 minutes)? 

Yes No 

I 

End of problem determination; call your service representative. 

See “Calling for Service” for more information. 

For information about the input inhibit indicator, use the PROBLEM 
procedure to refer to the Online Problem Determination Aids. If 
that information does not help, then call your service representative. 

See “Calling for Service” for more information. 
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8. Did you specify CONSOLE on the MSRJE procedure command? 

Yes No 

I 

You must specify CONSOLE to display host system messages. If you 
did not, then the messages should be in the System/36 history file. 

Call and ask the host system programmer: Was the host system 
generated for console support? 

Yes No 

I 

If you want host system messages to be displayed , ask the host 
system programmer to specify console support in the host system’s 
generation. In the meantime, if these messages were sent 
as printer output, they should be on the MSRJE printer or in a 
disk file. 

Are you using SNA? 

Yes No 

I 

Call your service representative. See “Calling for Service” for 
more information. 

Are any readers, printers, or punches active? (Enter the 
D M command to display MSRJE status.) 

Yes No 

I 

Call your service representative. See “Calling for Service” for 
more information. 

All LUs (logical units) may be busy (this is more likely to occur if 
only one logical unit is assigned). Wait until a reader, printer, 
or punch is not busy. If you still do not receive any host 
system messages, call your service representative. See “Calling 
for Service” for more information. 
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9. Is Waiting for a reader being displayed continuously (for at least 
2 minutes)? 

Yes No 

I 

Is Reader Input being displayed continuously (for at least 2 minutes)? 

Yes No 

I 

Is READFILE in progress being displayed continuously (for at 
least 2 minutes)? 

Yes No 

I 

Are you waiting for a console message from the host system? 
Yes No 

I 

Are you waiting for printer or punch output? 

Yes No 

I 

End of problem determination; call your service 
representative. See “Calling for Service” for more 
information. 

Go to step 10. 

Go to step 8. 

This is normal if a large file of data is being sent. If this 
is not a large file, and/or the reader does not end, call your 
service representative. See “Calling for Service” for more 
information. 

Did you enter an EOF statement, or did you press command key 7 or 19? 
Yes No 

I 

Enter another READFILE statement or, to end the reader, enter 
an EOF statement or press command key 7 or 19. 

Call your service representative. See “Calling for Service” 
for more information. 

Call and ask the host system operator or programmer to make sure: 

A. There are enough readers generated and available for use. 

B. There are enough LUs (logical units) assigned and/or started. 

C. The host readers are started. 

If actions A, B, and C do not solve the problem, call your service 
representative. See “Calling for Service” for more information. 
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10. You can get the information to answer the questions for this step by 

entering host system commands at the MSRJE console. If you do not know 
which commands to enter, you should call your host system operator. 

Are you waiting for print or punch output? 

Yes No 

I 

Go to step 11. 

Are there any jobs on the host system’s output queue? 

Yes No 

I 

Did you send a job using MSRJE? 

Yes No 

I 

You should send a job using MSRJE or, if the job should have 
been started at the host system, call the host system operator 
to ensure that it was started. If the job appears to have 
started but it is not producing any output, call and ask the 
host system programmer for assistance. 

Does the display station from which you sent the job have 
Console Input with Reader active displayed on line 21, 
or does it have Reader Input displayed on line 21? 

Yes No 

I 

Did you submit a valid job? 

Yes No 

I 

Submit a valid job and try again. 

The problem appears to be at the host system. Call and ask 
the host system operator or programmer for assistance. 

Do one of the following: 

A. If Console Input and Reader active are displayed, 

press command key 1 to display reader input, and then enter 
’.. EOF’. The job should now be sent to the host system. 

B. If Reader Input is displayed, enter ’.. EOF’. The job 
should now be sent to the host system. 

Are the host system printers and/or punches started for your remote 
system? 

(continued on next page) 
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Yes No 


Start the printers and/or punches, or ask the host system 
operator to start them. 

Is the output for your job being held at the host system? 

Yes No 

I 

Are the host printers and/or punches servicing the correct classes? 

Yes No 

I 

Change the device classes, or ask the host system operator to 
change them. 

Call and ask the host system programmer to verify that the numbers 
of printers and punches specified in the VTAM/NCP generation at 
the host system are the same as the numbers specified on CNFIGICF 
display 36.0, prompts 3 and 5. If these numbers are the same, call 
your service representative. See “Calling for Service” for more 
information. 

Release the job, or ask the host system operator to release it. 
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11. Did MSRJE handle your output correctly? 


Yes No 

I 

Is the forms name, specified in message RJE—4515, correct? 


Yes No 

I 

One of the following may be causing the problem: 

A. The host system was not generated to allow forms mount 
messages. 

B. For BSC, the format of the forms mount message is 
incorrect. The format of this message should be: 

RES: 

xx...IEF383Axx... (Where xx... is information not 
used to determine if it is a forms mount message.) 

JES2: 

xx...SETUP -- Rxx... or xx...SETUP - Rxx... 

(Where xx... is information not used to determine 
if it is a forms mount message.) 

JES3: 

xx...IAT7030xx... (Where xx... is information not 
used to determine if it is a forms mount message.) 

RSCS: 

xx...PRINT MOUNTxx... (Where xx... is information 
not used to determine if it is a forms mount message.) 

C. For SNA, the peripheral data information record (PDIR) 
is not being used. 

D. The forms set number, as specified on CNFIGICF display 
36.0, is incorrect. 

Do any of the above situations exist? 


Yes No 

End of problem determination; call your service 
representative. See “Calling for Service” for 
more information. 


Make the necessary corrections. If a problem still occurs, 
return to step 1 , discard any previously printed 
displays, and start again. 


(continued on next page) 
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V V 


One of the following, indicated by a message in the System/36 
history file, may be causing the problem: 

A. There is no forms control table. 

B. The forms control table name was not specified on CNFIGICF 
display 36.0. 

C. The forms control table cannot be used because of resource 
security. 

D. The forms control table cannot be shared. 

E. The forms control table was not created by RJTABLE. 

F. The specified entry was not found in the table. 

G. The specified entry is in the table, but it is not correct. 

Does a message in the history file indicate that any of the 
above situations exist? 

Yes No 

I 

End of problem determination; call your service 
representative. See “Calling for Service” for 
more information. 

Make the necessary corrections. Then if a problem still 
occurs, you should return to step 1 , discard any 
previously printed displays, and start again. 

End of problem determination; call your service representative. See 
“Calling for Service” for more information. 
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12. Are you waiting for MSRJE to end? 

Yes No 

I 

Did MSRJE end unexpectedly? 

Yes No 

I 

End of problem determination. If you did not find the 
problem, call your service representative. See 
“Calling for Service” for more information. 

Was a nonblank termination delay value specified 
during CNFIGICF on prompt 2 of display 34.0? 

Yes No 

I 

Was an .. END utility control statement entered by 
an MSRJE reader? (Check the history file.) 

Yes No 

I 

Call your service representative. For more information, 
see “Calling for Service.” 

This is normal operation. If you want MSRJE to remain active, 
do not enter the .. END statement from the MSRJE reader. 

This is normal operation. If you want MSRJE to remain active, 
enter blanks for display 34.0, prompt 2. 

Was a host reader started? To determine this, call the 

host system operator or enter the appropriate host system console 

command. 

Yes No 

I 

Use the appropriate host system commands to start a host reader. 

Are any MSRJE readers, printers, and/or punches active? 

(Enter the D M command to display MSRJE status.) 

Yes No 

1 l 

(continued on next page) 
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Yes No 


Was the .. END utility control statement used? (Check the 
history file.) 

Yes No 

I 

Was a nonblank termination delay value specified on 
display 34.0 during CNFiGICF? 

Yes No 

I 

Enter a END’ utility control statement at the 
MSRJE console. 

Is the MSRJE console active at any display station? 

(Enter the D M command to display MSRJE status.) 

Yes No 

Wait for the specified delay time. Then, if MSRJE does 
not end, call your service representative. For more 
information, see “Calling for Service.” 

Either end the MSRJE console by pressing command key 7 or 
enter a ’.. END’ utility control statement. 

Was a delay specified with the .. END statement? 

Yes No 

I 

Call your service representative. See 
“Calling for Service” for more information. 

Wait for the specified delay time, or enter the ’.. END’ utility 
control statement without the DELAY parameter. 

Wait or cancel the readers and/or writers. 
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Calling for Service 


If you do the following before you call for service, you will help the service 
representative determine what the problem is and correct it as quickly as possible. 

1. If you are able to use the system keyboard, do the following: 

a. Run the APAR procedure or DUMP procedure to save a copy of the dump 
area for the service representative, if a dump was taken. (See the System 
Reference manual and the System Problem Determination manual for 
information about these procedures.) 

b. Press the Print key to print the information that was displayed when the 
error occurred. 

c. Run the HISTORY procedure to save a copy of the history file for the 
service representative. (See the System Reference manual for information 
about the HISTORY procedure.) 

d. Use the D C command and the Print key to display and print the 
communications line status for the line being used for this job. (There are 
three display segments for each communications line.) 

e. Use the D M command and the Print key to display and print the MSRJE 
status display. 

f. Use the CNFIGICF procedure and the Print key to display and print all the 
MSRJE CNFIGICF displays for your subsystem. (See step 1, item C of 
the problem determination procedure for how to get the MSRJE displays 
printed, and, if necessary, see Chapter 2 for information about 
CNFIGICF.) 

Save the information you collected in actions a through f to give to the service 

representative. 

2. Fill out a Problem Summary Form. On this form, you can record information 

about the system conditions at the time the error occurred. Copies of this form 

are contained in the System Problem Determination manual. 
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Glossary 


#LIBRARY. The library, provided with the system, that 
contains the System Support Program Product. See system 
library. 

abnormal termination. A system failure or operator action 
that causes a job to end unsuccessfully. 

access method. The way that records in files are referred 
to by the system. The reference can be consecutive 
(records are referred to one after another in the order in 
which they appear in the file), or it can be random (the 
individual records can be referred to in any order). 

access mode. See access method. 

acquire. To assign a display station or session to a 
program. 

adapter. See communications adapter. 

addressing. (1) In data communications, the way that the 
sending or control station selects the station to which it is 
sending data. (2) A means of identifying storage 
locations. 

advanced program-to-program communications (APPC). 

Communications support that allows System/3 6 to 
communicate with other systems having the same support. 
APPC is the way that System/3 6 puts the IBM SNA 
LU-6.2 protocol into effect. 

allocate. To assign a resource, such as a disk file or a 
diskette file, to perform a specific task. 

alphabetic character. Any one of the letters A through Z 
(uppercase and lowercase). Some program products 
extend the alphabet to include the special characters #, $, 
and @. 

alphameric. Consisting of letters, numbers, and often 
other symbols, such as punctuation marks and 
mathematical symbols. 

alphanumeric. See alphameric. 


alternative index. An index that is built after an indexed 
file is created and that provides a different order for 
reading or writing records in the file. Contrast with 
primary index. 

alternative system console. A command display station 
that can be designated as the system console. 

| APPC. See advanced program-to-program communications 
j (APPC). 

application program. A program used to perform an 
application or part of an application. 

attribute. A characteristic. For example, an attribute for 
a displayed field could be blinking. 

autoanswer. In data communications, the ability of a 
station to receive a call over a switched line without 
operator action. Contrast with manual answer. 

autocall. In data communications, the ability of a station 
to place a call over a switched line without operator 
action. Contrast with manual call. 

autocall unit. A common carrier device that allows 
System/36 to automatically call a remote location. 

| batch. Pertaining to activity involving little or no operator 
| action. Contrast with interactive. 

batch processing. A processing method in which a 
program or programs process records with little or no 
operator action. Contrast with interactive processing. 

binary. (1) Pertaining to a system of numbers to the base 
two; the binary digits are 0 and 1. (2) Involving a choice 
of two conditions, such as on-off or yes-no. 

binary synchronous communications (BSC). A form of 
communications line control that uses transmission control 
characters to control the transfer of data over a 
communications line. Compare with synchronous data link 
control (SDLC). 

bind command. An SNA command used to define the 
protocols for a session. Contrast with unbind command. 


Glossary G-1 




bit. Either of the binary digits 0 or 1. See also byte. 

| block. (1) A group of records that is recorded or 
| processed as a unit. Same as physical record. (2) Ten 
| sectors (2560 bytes) of disk storage. (3) In data 
| communications, a group of records that is recorded, 

I processed, or sent as a unit. (4) In DW/36, a sequential 
| string of text (defined using the cursor movement keys or 
| line commands) that is treated as a unit. 

block check character. The character used in BSC to 
check that all of the bits transmitted were received. 

bps. Bits per second. 

BSC. See binary synchronous communications (BSC). 

| BSCEL (binary synchronous communications equivalence 
| link) subsystem. The SSP-ICF subsystem that provides 
| BSC communications with another System/36 and many 
| other BSC computers and devices. 

buffer. (1) A temporary storage unit, especially one that 
accepts information at one rate and delivers it at another 
rate. (2) An area of storage, temporarily reserved for 
performing input or output, into which data is read or 
from which data is written. 

byte. The amount of storage required to represent one 
character; a byte is 8 bits. 

I C & SM. See Communications and Systems Management 
| (C & SM). 

call. (1) To activate a program or procedure at its entry 
point. Compare with load. (2) In data communications, 
the action necessary in making a connection between two 
stations on a switched line. 

cancel. To end a task before it is completed. 

CCITT. Consultative Committee on International 
Telegraphy and Telephone. 

channel. A path along which data passes. 

channel control character. A value used by MSRJE to 
determine which line to skip to on a page before printing 
the next line of output. 

character. A letter, digit, or other symbol. 

character key. A keyboard key that allows the user to 
enter the character shown on the key. Compare with 
command keys and function key. 

| characters per inch (CPI). The number of characters 
| printed within an inch horizontally across a page. 


child. Pertaining to a secured resource, either a file or 
library, that uses the user list of a parent resource. A child 
resource can have only one parent resource. Contrast 
with parent. 

CICS subsystem. The SSP-ICF subsystem that allows 
binary synchronous communications with CICS/VS. 

CICS/VS. Customer Information Control System, which 
operates on a host system such as a System/370, or a 
30XX or 43XX processor. 

clocking. In data communications, a method of 
controlling the number of data bits sent on a 
communications line in a given time. 

close. To end the processing of a file. 

code. (1) Instructions for the computer. (2) To write 
instructions for the computer. Same as program. (3) A 
representation of a condition, such as an error code. 

collating sequence. The sequence in which characters are 
ordered within the computer for sorting, combining, or 
comparing. 

column separator. A symbol on each side of a position of 
a field on a display. This symbol does not occupy a 
position on the display. 

command. A request to perform an operation or a 
procedure. 

command display station. A display station from which an 
operator can start and control jobs. A command display 
station can become an alternative system console, can be 
designated as a subconsole, and can also be used as a data 
display station. See also alternative system console , data 
display station , and subconsole. 

command file. In the MSRJE utility, a disk file, procedure 
member, or source member that can contain MSRJE 
utility control statements and records to be transmitted to 
the host system. Contrast with data file. 

command keys. The keys on the display station keyboard 
that are used to request specific programmed actions. 
Compare with character key and function key. 

command processor. The part of the System Support 
Program Product that processes control commands and 
that passes procedure commands and operation control 
language statements to the initiator. 

common carrier. In data communications, any 
government-regulated company that provides 
communication services to the general public. 

| communications. See data communications. 
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communications adapter. A hardware feature that enables 
a computer or device to become a part of a data 
communications network. 

| Communications and Systems Management (C & SM). A 
| feature of the System Support Program Product that 
| contains the change management support (also referred to 
| as DSNX) and the problem management support, which 
| allows System/36 to generate and send alerts. 

| communications subsystem. See subsystem. 

compression. In data communications, a technique for 
removing strings of duplicate characters and for removing 
trailing blanks before transmitting data. 

configuration. The group of machines, devices, and 
programs that make up a data processing system. See also 
system configuration. 

configuration member. In data communications, a member 
that defines the attributes of a communications subsystem 
or line. 

configure. (1) To describe (to the system) the devices, 
optional features, and program products installed on a 
system. (2) To describe to SSP-ICF both the 
communication facilities connected to System/36 and the 
attributes of the subsystem and remote system. 

constant. A data item with a value that does not change. 
Contrast with variable. 

control station. The primary or controlling computer on a 
multipoint line. The control station controls the sending 
and receiving of data. 

control storage. Storage in the computer that contains the 
programs used to control input and output operations and 
the use of main storage. Contrast with main storage. 

| CPI. See characters per inch (CPI). 

current library. The first library searched for any required 
members. The current library can be specified during 
sign-on or while running programs and procedures. 

cursor. A movable symbol (such as an underline) on a 
display, usually used to indicate to the operator where to 
type the next character. 

data communications. The transmission of data between 
computers and/or remote devices (usually over a long 
distance). 

data display station. A display station from which an 
operator can only enter data. A data display station is 
acquired and controlled by a program. Contrast with 
command display station. 


data file. In the MSRJE utility, a disk file, procedure 
member, or source member that can contain only records 
to be transmitted to the host system. Contrast with 
command file. 

data item. A unit of information to be processed. 

data link. The equipment and rules (protocols) used for 
sending and receiving data. 

data link escape (DLE) character. In BSC, a transmission 
control character usually used in transparent text mode to 
indicate that the next character is a transmission control 
character. 

data management. The System Support Program Product 
support that processes a request to read or write data. 

data mode. In data communications, a time during which 
BSC is sending or receiving characters on the 
communications line. 

data stream. All information (data and control 
information) transmitted over a data link. 

deactivate. To make ineffective. For example, to 
deactivate security. 

decimal. Pertaining to a system of numbers to the base 
ten; decimal digits range from 0 through 9. 

| default. See default value. 

| default value. A value stored in the system that the 
| system uses when no other value is specified. 

delete. To remove. For example, to delete a file. 

delete-capable file. A file from which records can be 
logically removed without compressing the file. 

delimiter. A character or sequence of characters that 
marks the beginning or end of a unit of data. 

| direct file. A disk file in which records are referenced by 
| the relative record number. Contrast with indexed file and 
| sequential file. 

disable. In interactive communications, to end a 
subsystem and free the area of main storage used by that 
subsystem. Contrast with enable. 

disk. A storage device made of one or more flat, circular 
plates with magnetic surfaces on which information can be 
stored. 

disk drive. The mechanism used to read and write 
information on disk. 
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disk file. A set of related records on disk that is treated as 
a unit. See also record file and stream file. 

display. (1) A visual presentation of information on a 
display screen. (2) To show information on the display 
screen. 

display screen. The part of the display station on which 
information is displayed. 

display station. A device that includes a keyboard from 
which an operator can send information to the system and 
a display screen on which an operator can see the 
information sent to or the information received from the 
system. 

| distributed systems node executive (DSNX). Another 
| name for the change management support offered by the 
| Communications and Systems Management feature. This 
| support processes changes sent by a DSX host system. 

| DSNX. See distributed systems node executive (DSNX). 

EBCDIC. See extended binary-coded decimal interchange 
code (EBCDIC). 

EBCDIC character. Any one of the symbols included in 
the 8-bit EBCDIC set. 

EIA. Electronic Industries Association. 

| eight-line communications adapter/attachment (ELCA). A 

| feature that allows up to eight communication lines to be 
| connected to System/36 5360 System Unit. 

| ELCA. See eight-line communications adapter/attachment 
| (ELCA). 

emulation. Imitation; for example, the imitation of a 
computer or device. 

enable. In interactive communications, to load and start a 
subsystem. Contrast with disable. 

| enter. To type in information from a keyboard and press 
j the Enter key in order to send the information to the 
| computer. 

exchange station ID. In SDLC, a control field command 
and/or response for passing station IDs between the 
primary station and a secondary station. 

extendable disk file. A file that the system can increase in 
size whenever more space is needed. 

extended binary-coded decimal interchange code 
(EBCDIC). A set of 256 eight-bit characters. 


feature. A programming or hardware option, usually 
available at an extra cost. 

field. One or more characters of related information 
(such as a name or an amount). 

file. A set of related records treated as a unit. 

file name. The name used by a program to identify a file. 
See also label. 

| folder. A named area on disk that contains either 
| documents, profiles, office support information, or data 
| definitions. 

| folder member. A named collection of statements in a 
| folder. A document is an example of a folder member. 

| format. (1) A defined arrangement of such things as 
| characters, fields, and lines, usually used for displays, 

| printouts, files, or documents. (2) To arrange such things 
| as characters, fields, and lines. (3) In BASIC, a 
| representation of the correct form of a command or 
j statement. (4) In IDDU, a group of related fields, such as 
| a record, in a file. 

function key. A keyboard key that requests an action but 
does not display or print a character. The cursor 
movement and Help keys are examples of function keys. 
Compare with command keys and character key. 

handset. The part of a telephone used for talking and 
listening. 

hardware. The equipment, as opposed to the 
programming, of a system. 

| Help key. A function key that, when pressed, displays 
| online information or some part of the system help 
| support. 

| Help text. The part of the system help support that offers 
| guide information about menus and prompt displays. 

hex. See hexadecimal. 

hexadecimal. Pertaining to a system of numbers to the 
base sixteen; hexadecimal digits range from 0 (zero) 
through 9 (nine) and A (ten) through F (fifteen). 

history file. A file that contains a log of system actions 
and operator responses. 

horizontal tab table. A table used by MSRJE that contains 
values indicating the position on a line to skip to before 
printing. 

| host system. The primary or controlling computer in a 
| communications network. See also control station. 
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I/O. See input/output (I/O). 

ID. Identification. 

index. (1) A table containing the key value and location 
of each record in an indexed file. (2) A computer storage 
position or register, the contents of which identify a 
particular element in a set of elements. 

| indexed file. A file in which the key and the position of 
| each record are recorded in a separate portion of the file 
| called the index. Contrast with direct file and sequential 
I file. 

informational message. A message that provides 
information to the operator, but does not require a 
response. 

initial program load (IPL). The process of loading the 
system programs and preparing the system to run jobs. 

initialize. To prepare for use. For example, to initialize a 
diskette. 

input. Data to be processed. 

input stream. The sequence of operation control 
statements and data given to the system from an input 
device. 

input/output (I/O). Pertaining to either input or output, 
or both. 

inquiry mode. A mode during which the job currently 
running from a display station is interrupted so that other 
work can be done. The operator puts the display station 
in inquiry mode by pressing the Attn key. 

| interactive. Pertaining to activity involving requests and 
| replies as, for example, between an operator and a 
| program or between two programs. Contrast with batch. 

Interactive Communications Feature (SSP-ICF). A feature 
of the System Support Program Product that allows a 
program to interactively communicate with another 
program or system. 

interactive processing. A processing method in which each 
operator action causes a response from the program or the 
system. Contrast with batch processing. 

interrupt. (1) To temporarily stop a process. (2) In data 
communications, to take an action at a receiving station 
that causes the sending station to end a transmission. 

IPL. See initial program load (IPL). 

job. (1) A unit of work to be done by a system. (2) One 
or more related procedures or programs grouped into a 
procedure. 


job file. A disk file that exists until the job that uses it 
ends. 

job queue. A list of jobs waiting to be processed by the 
system. 

job step. A unit of work represented by a single program 
or a procedure that contains a single program. A job 
consists of one or more job steps. 

K-byte. 1024 bytes. 

key. One or more characters used to identify the record 
and establish the record’s order within an indexed file. 

keyword. A symbol that identifies a parameter. 

| label. (1) The name in the disk or diskette volume table 
| of contents or on a tape that identifies a file. See also file 
| name. (2) The name that identifies a statement. 

library. (1) A named area on disk that can contain 
programs and related information (not files). A library 
consists of different sections, called library members. (2) 
The set of publications for a system. 

library member. A named collection of records or 
statements in a library. The types of library members are 
load member , procedure member , source member , and 
subroutine member. 

load. (1) To move data or programs into storage. (2) To 
place a diskette into a diskette drive or a magazine into a 
diskette magazine drive. (3) To insert paper into a printer. 

| load member. A library member that contains information 
| in machine language, a form that the system can use 
| directly. Contrast with source member. 

load module. A program in a form that can be loaded into 
main storage and run. The load module is the output of 
the overlay linkage editor. 

| local. Pertaining to a device, file, or system that is 
| accessed directly from your system, without the use of a 
| communications line. Contrast with remote. 

| location name. In interactive communications, the 
| identifying name associated with a particular system or 
| device. 

logical unit (LU). The part of a system or device in an 
SNA network that allows a user or program to use the 
communication network. 

LU. See logical unit (LU). 

main storage. The part of the processing unit where 
programs are run. Contrast with control storage. 
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main storage processor. Hardware that performs the 
machine language instructions in main storage. 

manual answer. In data communications, a line type 
requiring operator actions to receive a call over a switched 
line. Contrast with autoanswer. 

manual call. In data communications, a line type requiring 
operator actions to place a call over a switched line. 
Contrast with autocall. 

menu. A displayed list of items from which an operator 
can make a selection. 

message identification. A field in the display or printout of 
a message that directs the user to the description of the 
message in a message guide or a reference manual. This 
field consists of up to four alphabetic characters, followed 
by a dash, followed by the message identification code. 

message identification code (MIC). A four-digit number 
that identifies a record in a message member. This 
number can be part of the message identification. 

MIC. See message identification code (MIC). 

MLCA. See multiline communications adapter/attachment 
(MLCA). 

modem. See modulator-demodulator (modem). 

modulator-demodulator (modem). A device that converts 
data from the computer to a signal that can be transmitted 
on a communications line, and converts the signal received 
to data for the computer. 

| MSRJE. See Multiple Session Remote Job Entry 
| (MSRJE). 

multiline communications adapter/attachment (MLCA). A 
feature that allows up to four communication lines to be 
connected to System/36. 

multiple. More than one. 

| Multiple Session Remote Job Entry (MSRJE). A feature 
| of the System Support Program Product that allows one or 
| more remote job entry sessions to operate on a host 
| system, such as a System/370, or a 30XX or 43XX 
| processor, at the same time. 

multipoint. In data communications, pertains to a network 
that allows two or more stations to communicate with a 
single system on one line. 

negative response. In data communications, a reply 
indicating that data was not received correctly or that a 
command was incorrect or unacceptable. 


nest. To incorporate a structure or structures of some 
kind into a structure of the same kind. For example, to 
nest one loop (the nested loop) within another loop (the 
nesting loop); to nest one subroutine (the nested 
subroutine) within another subroutine (the nesting 
subroutine). 

| network. A collection of data processing products 
| connected by communication lines for information 
| exchange between stations. 

non-return-to-zero inverted (NRZI). On System/36, a 
method of data transmission where the signal is changed 
to transmit a 0 bit. For the 1 bit the signal stays the same. 
This ensures that the signal does not stay the same for an 
extended period of time. 

nonswitched line. A connection between computers or 
devices that does not have to be established by dialing. 
Contrast with switched line. 

NRZI. See non-return-to-zero inverted (NRZI). 

null character. The character hex 00, used to represent 
the absence of a printed or displayed character. 

null character string. Two consecutive single quotation 
marks that specify a character constant of no characters. 

numeric. Pertaining to any of the digits 0 through 9. 

object program. A set of instructions in machine-runnable 
form. The object program is produced by a compiler from 
a source program. 

OCL. See operation control language (OCL). 

offline. Neither controlled directly by, nor communicating 
with, the computer, or both. Contrast with online. 

online. Being controlled directly by, or directly 
communicating with, the computer, or both. Contrast 
with offline. 

open. To prepare a file for processing. 

operand. A quantity of data that is operated on, or the 
address in a computer instruction of data to be operated 
on. 

operation control language (OCL). A language used to 
identify a job and its processing requirements to the 
System Support Program Product. 

output. The result of processing data. 

output stream. Messages and other output data, displayed 
on output devices by an operating system or a processing 
program. 
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pad. To fill unused positions in a field with dummy data, 
usually zeros or blanks. 

parameter. A value supplied to a procedure or program 
that either is used as input or controls the actions of the 
procedure or program. 

parent. Pertaining to a secured resource, either a file or 
library, whose user list is shared with one or more other 
files or libraries. Contrast with child. 

password. A string of characters that, when entered along 
with a user ID, allows an operator to sign on to the 
system. 

password security. A System Support Program Product 
option that helps prevent the unauthorized use of a display 
station, by checking the password entered by each 
operator at sign-on. 

peripheral data set information record. A record sent to 
MSRJE by the host system to control the format of 
printed output. 

| phone list. A list of telephone numbers to be called using 
| a communications program and the autocall or X.25 
| feature. 

physical record. (1) A group of records that is recorded or 
processed as a unit. Same as block. (2) A unit of data 
that is moved into or out of the computer. 

point-to-point line. A communications line that connects 
a single remote station to a computer. 

poll. To execute a polling sequence. 

polling. A method for determining whether each of the 
stations on a communications line has data to send. 

| port. A part of the system unit or remote controller to 
| which cables for display stations and printers are attached. 

position. The location of a character in a series, as in a 
record, a displayed message, or a computer printout. 

positional parameter. A parameter that must appear in a 
specified location, relative to other positional parameters. 

primary index. The index that is built when a file is 
created. Contrast with alternative index. 

print image. A character set that corresponds to the 
characters on a print belt. 

printout. Information from the computer that is produced 
by a printer. 


| priority. The relative ranking of items. For example, a 
| job with high priority will be run before one with regular 
| or low priority. 

problem determination. The process of identifying why 
the system is not working. Often this process identifies 
programs, equipment, data communications facilities, or 
user errors as the source of the problem. 

procedure. A set of related operation control language 
statements (and, possibly, utility control statements and 
procedure control expressions) that cause a specific 
program or set of programs to be performed. 

procedure command. A command that runs a procedure. 

procedure member. A library member that contains the 
statements (such as operation control language 
statements) necessary to perform a program or set of 
programs. 

processing unit. The part of the system unit that performs 
instructions and contains main storage. 

program. (1) A sequence of instructions for a computer. 
See source program and load module. (2) To write a 
sequence of instructions for a computer. Same as code. 

program product. A licensed program for which a fee is 
charged. 

Programming Request for Price Quotation (PRPQ). A 

program created especially for a particular group of 
customers or an application. Documentation for the 
program is provided only to those customers who order 
the PRPQ. 

prompt. A displayed request for information or operator 
action. 

protocol. In data communications, the rules for 
transferring data. 

| PRPQ. See Programming Request for Price Quotation 
I (PRPQ). 

record. A collection of fields that is treated as a unit. 

relative file. Same as direct file. 

| remote. Pertaining to a device, file, or system that is 
| accessed by your system through a communications line. 

| Contrast with local. 

remote job entry (RJE). Sending job instructions and 
possibly data to a remote system requesting it to run a job. 

request unit. In SNA, the record transmitted to the other 
system. This record can contain a request, data, or both. 
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| resource security. A System Support Program Product 
| option that restricts the use of information in files, 

| libraries, folders, and folder members to specified users. 

response unit. In SNA, the record sent to respond to a 
request. The response can be either positive or negative 
and can include control information. 

RJE. See remote job entry (RJE). 

run. To cause a program, utility, or other machine 
function to be performed. 

SDLC. See synchronous data link control (SDLC). 

sequential access. An access method in which records are 
read from, written to, or removed from a file based on the 
logical order of the records in the file. 

sequential file. A file in which records occur in the order 
in which they were entered. Contrast with direct file and 
indexed file. 

session. (1) The logical connection by which a System/3 6 
program or device can communicate with a program or 
device at a remote location. (2) The length of time that 
starts when an operator signs on the system and ends 
when the operator signs off the system. 

severity code. A code that indicates how serious a 
compiling or an operating error is. 

sign off. To end a session at a display station. 

sign on. (Verb) To begin a session at a display station. 

| single line communications adapter/attachment (SLCA). In 
| data communications, a feature that allows a single 
| communications line to be connected to System/36. 

| SLCA. See single line communications adapter/attachment 
j (SLCA). 

SNA. See systems network architecture (SNA). 

SNA Upline Facility (SNUF). The SSP-ICF subsystem 
that allows System/36 to communicate with CICS/VS 
and IMS/VS application programs. 

SNUF. See SNA Upline Facility (SNUF). 

source member. A library member that contains 
information in the form in which it was entered, such as 
RPG specifications. Contrast with load member. 

source program. A set of instructions that are written in a 
programming language and that must be translated to 
machine language before the program can be run. 


special character. A character other than an alphabetic or 
numeric character. For example; *, +, and % are special 
characters. 

spool file. A disk file that contains output that has been 
saved for later printing. 

spooling. The part of the System Support Program 
Product that saves output on disk for later printing. 

SSP. See System Support Program Product (SSP). 

SSP-ICF. See Interactive Communications Feature 
(SSP-ICF). 

station. A computer or device that can send or receive 
data. 

status. A condition. For example, the status of a printer, 
a job, or a communications line. 

subconsole. A display station that controls a printer or 
printers. 

subroutine member. A library member that contains 
information that must be combined with one or more 
members before being run by the system. 

| subsystem. The part of communications that handles the 
| requirements of the remote system, isolating most 
| system-dependent considerations from the application 
| program. 

switched line. In data communications, a connection 
between computers or devices that is established by 
dialing. Contrast with nonswitched line. 

switched network backup (SNBU). In data 
communications, a technique that provides a switched line 
connection when a nonswitched line fails. 

synchronous. Occurring in a regular or predictable 
sequence. 

synchronous data link control (SDLC). A form of 
communications line control that uses commands to 
control the transfer of data over a communications line. 
Compare with binary synchronous communications (BSC). 

system. The computer and its associated devices and 
programs. 

system configuration. A process that specifies the 
machines, devices, and programs that form a particular 
data processing system. 

| system console. A display station from which a user can 
| keep track of and control system operation. 
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system library. The library, provided with the system, that 
contains the System Support Program Product and is 
named #LIBRARY. 

system printer. The printer that is used for any printed 
output that is not specifically directed to another printer. 

System Support Program Product (SSP). A group of 
licensed programs that manage the running of other 
programs and the operation of associated devices, such as 
the display station and printer. The SSP also contains 
utility programs that perform common tasks, such as 
copying information from diskette to disk. 

| system unit. The part of the system that contains the 
| processing unit, the control panel, the disk drive and the 
| disk, and either a diskette drive or a diskette magazine 
| drive. 

systems network architecture (SNA). A set of rules for 
controlling the transfer of information in a data 
communications network. 

table. A collection of data in which each item is uniquely 
identified by a label, by its position relative to the other 
items, or by some other means. 

terminal. In data communications, a device, usually 
equipped with a keyboard and a display device, capable of 
sending and receiving information over a communications 
line. 

translation table. A table that provides replacement 
characters for characters that cannot be printed by the 
3262 printer. 

transmission control characters. In data communications, 
special characters that are included in a message to control 
communication over a data link. For example, the sending 
station and the receiving station use transmission control 
characters to exchange information; the receiving station 
uses transmission control characters to indicate errors in 
data it receives. 

transparent data. Data that can contain any hexadecimal 
value. 

| transparent text mode. A mode that allows BSC to send 
| and receive messages containing any of the 256 character 
| combinations in hexadecimal, including transmission 
| control characters. 

truncate. To shorten a field or statement to a specified 
length. 

turnaround. Changing a communications line from 
transmit mode to receive mode or from receive mode to 
transmit mode. 


turnaround time. The time interval required to reverse the 
direction of transmission over a communication line. 

unbind command. An SNA command used to reset the 
protocols for a session. Contrast with bind command. 

unique. The only one. 

unprocessed record. A record that is not transformed by 
MSRJE before it is stored. 

utility control statement. A statement that gives a utility 
program information about the way the program is to 
perform or the output it is to produce. 

utility program. A System Support Program Product 
program that allows you to perform a common task, such 
as copying information from diskette to disk. 

valid. (1) Allowed. (2) True, in conforming to an 
appropriate standard or authority. 

variable. A name used to represent a data item whose 
value can change while the program is running. Contrast 
with constant. 

vertical tab table. A table used by MSRJE that contains 
values indicating the line on a page to skip to before 
printing. 

voice-grade telephone line. A telephone line that is 
normally used for transmission of voice communications. 
The line requires a modem for data communications. 

volume table of contents (VTOC). An area on a disk or 
diskette that describes the location, size, and other 
characteristics of each file and library on the disk or 
diskette. 

VTOC. See volume table of contents (VTOC). 

work station. A device that lets people transmit 
information to or receive information from a computer; 
for example, a display station or printer. 

World Trade. (1) Pertains to the distinction between the 
US and the rest of the world. (2) Pertains to the 
combination of: 

- IBM World Trade Americas/Far East 
Corporation 

- IBM World Trade Europe/Middle East/Africa 
Corporation 


X.21. In data communications, a specification of the 
CCITT that defines the connection of data terminal 
equipment to an X.21 (public data) network. 
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X.21 feature. The feature that allows System/36 to be 
connected to an X.21 network. 

X.25. In data communications, a specification of the 
CCITT that defines the interface to an X.25 (packet 
switching) network. 


3270 BSC Support subsystem. The subsystem that 
provides program-to-program communications with 
IMS/VS, CICS/VS, TSO, VM, or system application 
programs using 3270 BSC protocols, and provides support 
for the BSC portion of the 3270 Device Emulation 
feature. 


X.25 feature. The feature that allows System/36 to 
connect to an X.25 network. 
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JES2 7-6 
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JESS 7-7 

JES2 


RTAM 7-6 

BSC 

7-8 

VM370RSCS 7-7 
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SNA 

JES2 


IES3 8-4 

BSC 

7-8 

activating a configuration 3-1 

SNA 

8-6 

activating a location 3-1 

&NUMCMBS 


activating a remote location 

JES2 


BSC 2-13 

BSC 

7-8 

SNA 2-32 

&NUMJOES 


activating an MSRJE reader 3-13 

JES2 


add to existing file, punch output to a data file 5-31 

BSC 

7-9 

adding print output to an existing compressed file 5-21 

SNA 

8-7 

aligning forms, printer output 5-13 

&NUMLNES 


application ID 2-40 

JES2 


VSE POWER 

BSC 

7-9 

SNA 8-39 

SNA 

8-7 

application ID, RTAM macro 

&NUMRJE 


RES 

JES2 


SNA 8-30 

BSC 

7-9 

application name 

SNA 

8-7 

IES2 

&NUMTPBF 


SNA 8-5 

JES2 


JES3 

SNA 

8-7 

SNA 8-22 

&PRTRANS 


APPLID 

JES2 


JES2 

BSC 

7-9 

SNA 8-5 

SNA 

8-8 

IES3 

&SPOLMSG 


SNA 8-22 

JES2 


APPLID parameter 

SNA 

8-8 

host system name 2-33 

JES2 BSC 

7-10 

value 2-37 

&TPBFSIZ 


APPLID, RTAM macro 

IES2 


RES 

BSC 

7-10 

SNA 8-30 

SNA 

8-8 

assigning a terminal to a line 

&TPIDCT 


JES3 

JES2 


BSC 7-24 

SNA 

8-8 

associated line member 

&WAITIME 


subsystem member 

JES2 


BSC 2-11 

SNA 

8-8 

SNA 2-29 

&WAITIMT 


associating subsystem member with a line member 

JES2 


BSC 2-11 

BSC 

7-10 

SNA 2-29 


*host name*OS 
VS1* 2-14 

*OS 

OSl*host name* 2-14 


ATTR OCL statement 2-15, 2-34 
attributes of BSC subsystem member 2-14 
authority level, console 
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JESS 

BSC 7-22 

authority level, CONSOLE parameter 
JES3 

SNA 8-24 
automatic logoff 
RES 

BSC 7-29 
automatic logon 
JES3 

SNA 8-26 

automatic mode, printer 
JES2 

BSC 7-14 
automatic mode, punch 
JES2 

BSC 7-17 

automatic start of printer 
JES2 

SNA 8-13 

automatic start of punch 
JES2 

SNA 8-17 


B 


bind command B-l 

block location, specifying 5-8 

BSC 

activating a remote location 2-13 
associating subsystem member with a line 
member 2-11 

changing a subsystem member 2-8 
communications access methods 7-7 
JES2 7-6 
RTAM 7-6 
VM370 RSCS 7-7 
communications controller 7-6 
configuring the subsystem 2-7 
creating a new location 2-12 
creating a subsystem member 2-8 
creating a subsystem member from existing 2-8 
creating from existing 2-12 
defining subsystem member attributes 2-14 
deleting a subsystem member 2-8 
describing MSRJE characteristics 2-7 
editing an existing location 2-12 
existing member library name 2-9 
existing member name 2-9 
forms control table defaults 2-19 
forms control table name 2-19 
forms set table 2-19 
host subsystem work sheets A-2 
host system name 2-14 
host systems supported by MSRJE 1-6 
JES2 

communications access 7-6 
host subsystem work sheets A-2 


initialization parameters 7-8 
number of host readers 2-23 
number of printers 2-20 
number of punches 2-20 
SIGNON format 2-16 
transparency 2-23 
JES2 SIGNON 

passwordl 2-16 
pa$sword2 2-17 
RMTnnn parameter 2-16 
JESS 

communications access 7-7 
host subsystem work sheets A-4 
initialization parameters 7-21 
number of host readers 2-23 
number of printers 2-20 
transparency 2-23 
JES3 SIGNON 
format 2-17 
namex 2*17 
passwordl 2-17 
password2 2-17 
job priority 2-15 
library for subsystem member 2-8 
LOGON SIGNON 2-16 
maximum number of printers 2-20 
MSRJE characteristics 2-7 
naming remote location 2-13 
number of host readers 2-23 
number of MSRJE readers 2-22 
printer attributes 2-19 
printer file sequence number 2-20 
punch attributes 2-19 
punch file sequence number 2-21 
reader attributes 2-22 
remote location 
activating 2-13 
naming 2-13 
remote system 
selecting 2-12 

removing a remote location 2-12 
RES 

example C-l 
generation example 7-32 
host subsystem work sheets A-6 
line member configuration example 
number of host readers 3-23 
number of printers 2-20 
transparency 2-23 
RES LOGON 
format 2-17 
MAIL 2-18 
NOTICES 2-17 
password 2-17 
PROC(procnarae) 2-17 
TERM(termld) 2-17 
userid 2*17 

reviewing a remote location 2-12 
reviewing a subsystem member 2-8 
RSCS 


C-l, C-4 
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host system generation 7-38 
RTAM 

communications access 7-6 
macromstructions 7-28 
parameters 7-29 
stage 1 7-28 

stage 2 7-31 

selecting remote system 2-12 
selecting subsystem type 2-11 
SIGNON LOGON 2-16 
specifying member type 2-10 
stage 1 of RTAM generation 7-28 
stage 2 of RTAM generation 7-31 
subsystem definition 2-7 
example 2-7 
subsystem member 
attributes 2-14 

subsystem member configuration 2-7 
subsystem member name 2-8 
subsystem member selection 2-11 
termination delay 2-15 
text transparency 2-23 
viewing a subsystem member 2-8 
VM370 RSCS 

communications access 7-7 
host subsystem work sheets A-8 
number of host readers 2-23 
number of printers 2-20 
transparency 2-23 
VM370RSCS SIGNON 
format 2-18 
password 2-18 
REMOTEnn 2-18 
3705 PEP generation example 7-35 
buffer size 
JES2 

SNA 8-9 
RES 

BSC 7-30 
SNA 8-29 
VM370 RSCS 
BSC 7-41 
buffersize, RJPTERM 
JES3 

BSC 7-25 
BUFSIZE parameter 
JES2 

SNA 8-9 
BUFXSIZ parameter 
RES 

SNA 8-29 


c 


CANCEL utility control statement 4-9 
format 4-9 
result of 4-9 

CANCEL utility control statment 
parameters 


LRBn 4-9 

PRn 4-9 

RDn 4-9 

canceling a utility function 4-9 
canceling the control table utility 5-7 
card control character insertion 
JES2 

SNA 8-17 
card reader definition 
JES2 

BSC 7-19 

carriage control character insertion 
JES2 

SNA 8-13 

carriage control characters 5-15 
CCTL parameter 
JES2 

SNA 8-13 

CCTL parameter, punch 
JES2 

SNA 8-17 

changing a subsystem member 
BSC 2-8 
SNA 2-26 
changing defaults 
forms control table 

print destination B-6 

punch destination D-9 
changing forms control table defaults 
print destination D-6 
punch destination D-9 
changing the forms name 

SETFORM utility control statement 4-11 
channel control character 5-15 
character compression 
JES3 

BSC 7-27 

characteristics of MSRJE 
BSC 2-7 

characters per inch, printer output 5-14 
checkpoint cards 
JES2 

SNA 8-17 
checkpoint pages 
JES2 

SNA 8-14 
checkpoint, printer 
JES2 

BSC 7-15 
CKPTLNS parameter 
JES2 

SNA 8-14 

CKPTLNS parameter, punch 
JES2 

SNA 8-17 
CKPTPGS 
JES2 

SNA 8-14 

CKPTPGS parameter, punch 
JES2 

SNA 8-17 
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CMB 

SNA 

default 2-46 
CMD default 2-24 

CNFIGICF procedure command 2-2, 3*1 
CNFIGSSP procedure 2-1 
CNMSGNO parameter 
RES 

SNA 8-29 

COMDEFN statement 8-22 
command keys 
CNFIGICF 
BSC 2-7 

from MSRJE console 3-12 
READFILE in progress display 3-19 
subsystem member configuration 2-10 
command keys used 
CNFIGICF 
SNA 2-25 

COMMAND parameter 

MSRIE procedure command 3-5 
commands 

ENABLE C-9 
communications access methods 
BSC 7*6 
JES2 7-6 
JES3 7*7 
RTAM 7-6 
VM370RSCS 7-7 
SNA 

JES2 8-4 
JES3 8-4 
RTAM 8-4 

communications controller 
BSC 7-6 
SNA 8-3 

communications line definition 
JES2 

BSC 7-11 

communications link, example of establishing E-l 
compaction 
JES3 

SNA 8-25 
compaction, printer 
JES2 

SNA 8-18 

compaction, RTAM macro 
RES 

SNA 8-30 
compactions 
JES2 

SNA 8-14 

compression and expansion 
JES2 

SNA 8-9 
compression, printer 
JBS2 

SNA 8-15 
compression, punch 
JES2 


SNA 8-18 

compression, RTAM macro 
RES 

SNA 8-30 

computer input devices 1-1 
CONPR parameter 
RES 

SNA 8-29 

console 

HES3 

BSC 7-21 
console authority level 
IES3 

BSC 7-22 
console input 

ENTER key 3-11 

input area 3-11 

logged to history file 3-10 

record length 3-11 

utility control statements 3-11,4-1 

CANCEL 3-11 

END 3-11 

LIBRARY 3-11 

READFILE 3-11 

SETFORM 3-11 
console message buffers 
RES 

SNA 8-29 
console output 
RES 

BSC 7-30 
CONSOLE parameter 

MSRIE procedure command 3-7 
CONSOLE parameter, authority level 
JES3 

SNA 8-24 

CONSOLE parameter, destcode 
JES3 

SNA 8-22 

CONSOLE parameter, line length 
1ES3 

SNA 8-24 

CONSOLE parameter, message buffer size 
JES3 

SNA 8-24 

CONSOLE parameter, message classes 
JES3 

SNA 8-22 

CONSOLE parameter, message destination 
JES3 

SNA 8-22 

CONSOLE parameter, name 
1ES3 

SNA 8-22 

CONSOLE parameter, TYPE 
JES3 

SNA 8-22 
console printer 
RES 

SNA 8-29 
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console support 
JES2 

BSC 7-12 
SNA 8-10 
JES3 

BSC 7-25 
SNA 8-22 
RES 

BSC 7-29 
SNA 8-28 
VSE POWER 
SNA 8-40 
control output 

print output to compressed file 
printer definition 5-22 
control table entry 
print data 

compressed file output 5-3 
output to printer 5-2 
spooled output 5-2 
punch data 

compressed file output 5-5 
disk file output 5-4 
Control Table menu 

control table utility 5-6 
control table utility 5-1 
canceling 5-7 
Control Table menu 5-6 
adding to a table 5-6 
create a new table 5-6 
existing table name 5-7 
new table name 5-7 
preferred disk location 5-7 
removing a table 5-6 
removing from a table 5-6 
selecting the operation 5-6 
table name 5-7 
updating a table 5-6 
defining the table name 5-7 
entry menu 5-9 
heading 5-9 
host forms name 5-1 
naming entries 5-1 
print default 5-1,5-29 
print output to compressed file 5-19 
error save 5-20 
existing file 5-21 
file extendability 5-20 
file location 5-20 
file name 5-19 
file name examples 5-19 
file size 5-20 
freeing unused space 5-21 
number of blocks 5-20 
preferred location 5-20 
resource security 5-20 
saving the file 5-20 
user ID 5-20 
print output to disk 

extending a file 5-20 
print style 5-13,5-23 


printer data streams 5-2 
printer output 

align forms 5-13 
carriage control characters 5-15 
defining the characters per inch 5-14 
defining the lines per inch 5-14 
formatting of 5-14 
last line on a page 5-15 
lines per page 5-14 
local forms name 5-12 
selecting the printer 5-12 
specifying line skips 5-15 
spooled display 5-15 
spooling 5-13 
punch default 5-1 
punch output 5-4 
punch output to a data file 
add to existing file 5-31 
delete capable file 5-32 
extending the file 5-32 
file extendability 5-32 
file location 5-32 
file name 5-30 
file size 5-32 
file type 5-31 
freeing unused space 5-31 
indexed file 5-33 
library for procedure 5-30 
preferred file location 5-32 
procedure library 5-30 
procedure name 5-30 
record length 5-32 
resource security 5-30 
save on error 5-31 
user ID 5-30 

punch output to a disk file 5-30 
punch output to compressed file 5-34 
error save 5-35 
extending the file 5-35 
file extendability 5-35 
file location 5-35 
file name 5-34 
file name example 5-34, 5-37 
file size 5-35 
freeing disk space 5-36 
preferred location 5-35 
resource security 5-35, 5-38 
saving the file 5-35 
user ID 5-35, 5-38 
spooled output 5-16 
starting 5-6 
controlling MSR JE 4-1 
controlling print output 5-2 
converting from System/34 to System/36 1-10 

converting print data to printed output 1-8 
converting punch data to data files 1-8 
copying lines of data 
console input 3-12 
reader input 3-17 
correcting problems F-1 
create a subsystem member from existing 
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SNA 2-26 

create new subsystem member 
SNA 2-26 

create new subsystem member from existing 
BSC 2-8 

creating a subsystem member 
BSC 2-8 

creating the forms control table C-25 
current library 

LIBRARY utility control statement 4-7 


D 


D parameter 

MSRJE procedure command 3-5 
data block size 
VSE POWER 
SNA 8-39 
DATA parameter 
JES2 2-37 

MSRJE procedure command 3-5 
data streams 1-3 
default for CMD 
SNA 2-46 
default for DEL 
SNA 2-46 
default for TYPE 
SNA 2-45 

default message class for a reader 
JES2 

SNA 8-20 
default value 
CMD 2-24 
DEL 2-24 
TYPE 2-24 
defaults 

forms control table 
changing D-6 
print D-l 
punch D-4 

defining a control table 5-1 
defining a print default entry 5-29 
defining an RJE terminal 
JES3 

BSC 7-25 

defining remote work stations 
JES2 

BSC 7-11 

defining the remote location 2-32 
defining the subsystem member 
SNA 2-25 
DEL 
SNA 

default 2-46 
DEL default 2-24 
DEL parameter 

MSRJE procedure command 3-6 
delay time for termination 


BSC 2-15 
SNA 2-33 

delete capable file, punch output to a data file 5-32 
delete capable files 2-24 
SNA 2-46 

delete subsystem member 
BSC 2-8 
SNA 2-26 
destination 

punch output 3-23 
destination of print output 3-21 
device definition 
JES3 

BSC 7-23 
SNA 8-24 
DEVICE statment 
JES3 

SNA 8-24 

diagnosing problems E-l 
dal feature 
JES3 

BSC 7-23 
DISABLE 

MSRJE active 3-28 

disabling an MSRJE remote location 3-28 
DISCINTV 
JES2 

SNA 8-10 
disconnect interval 
JES2 

BSC 7-12 
SNA 8-10 

disk 

file utility 6-1 
input 6-1 
file utilty 

OCL statements 6-2 
preferred location 

compressed disk output, print 5-20 
compressed disk output, punch 5-35 
Control Table menu 5-7 
punch output to a disk file 5-32 
disk file creation date 

MSRJE procedure command 3-4 
disk input ot MSRJE reader 3-18 
DISK parameter 

MSRJE procedure command 3-5 
Dup key 

from MSRJE console 3-12 
from Reader Input display 3-17 


E 


editing subsystem member 
SNA 2-26 

ENABLE command C-9 
ENABLE procedure command 3-1 
format 3-1 
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parameters 

library name 3*2 
line number 3*2 
location 3-2 
NOSHOW 3*2 
SHOW 3*2 

subsystem member name 3*1 
END utility control statement 4*13 
format 4-13 
ending a reader 4-8 
ending an MSRJE session 3*26 
ending reader input 4*8 
ending subsystem member definition 
SNA 2*46 

entering jobs from a remote location 1*2 
entry menu 

control table utility 5*9 
beading 5-9 

EOF utility control statement 4*8 
format 4*8 
result of 4*8 

terminating an MSRJE reader 3*15 
error save, print output to compressed file 5*20 
error save, punch output to compressed file 5*35 
establishing a communications link, example E-l 
existing library name 
SNA 2*27 

existing member library name 
BSC 2*9 

existing member name 
BSC 2*9 
SNA 2*27 

extending a file, print output to compressed file 5*20 
extending the file, punch output to a data file 5*32 
extending the file, punch output to compressed file 5*35 


F 


file class 

VM370RSCS 
BSC 7*38 

file extendability, print output to compressed file 5*20 

file extendability, punch output to a data file 5*32 

file extendability, punch output to compressed file 5-35 

file location, print output to compresses disk 5*20 

file location, punch output to a data file 5*32 

file location, punch output to compressed file 5*35 

file name example, punch output to compressed file 5*34 

file name examples 5*49 

file name, print output to compressed file 5*19 

file name, punch output to a data file 5-30 

file name, punch output to compressed file 5-34 

file save on error 5*31 

file size, print output to compressed file 5-20 

file size, punch output to a data file 5*32 

file size, punch output to compressed file 5-35 


file type, punch output to a data file 5*31 
filling out host system work sheets 2*2 
first LOGON 2*35 
format 

ENABLE procedure command 3*1 
formatted LOGON 
SNA 2*3$ 

formatting printer output 5*14 
forms control table 
BSC 

print default 2-19 
punch default 2*19 
creation example €*25 
default entry 

changing 0*6 
print 04 
punch D-4 

entry names 3-21,3*24 
host forms names 3*21,3-24 
matching host forms name to table entries 5*1 
name of 5*7 
print entries 5-2 
print output 3-21 
punch output 3*23 
taking advantage of 3-23,3-25 
forms control table name 
BSC 2-19 
SNA 2*41 
forms identifier 
JES2 

BSC 7*16 
SNA 8*15 
forms identifier punch 
JES2 

BSC 7*18 
forms identifier, punch 
JES2 

SNA 8*18 
forms name 

changing 4*11 
FORMS parameter 
JES2 

SNA 8*15 

FORMS parameter, punch 
JES2 

SNA 8-18 
forms set 

BSC 2*19 
SNA 2*41 
forms set to use 
SNA 2*41 
FORMS, punch 
JES2 

BSC 7-18 

freeing disk space, punch output to compressed file 5*36 
freeing unused space, print output to compressed 
file 5*21 

freeing unused space, punch output to a data file 5*31 
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generation 


language 


BSC 

7-34 

SNA 

8-32 

R™2 


BSC 

7-28 

RES example 

BSC 

7-32 

SNA 

8-31 

RSCS host system 

RTAM 

SNA 

7-28, 8-28 

JES2 

8-5 

JES3 

8-22 

RES 

8-27 


VSE POWER 8-39 
VS 1 system requirements 8-27 
3705 NCP 
PEP 7-34 

3705 PEP example 7-35 
3705-11 example 8-34 
generation requirements 
RES 

SNA 8-27 

group name, work station 
JES3 

SNA 8-25 


H 


handling output data streams 5*1 
history file 3-25 

console input logged to 3-10 
holding input from a reader 
JES2 

SNA 8-20 
holding reader jobs 
JES2 

BSC 7-19 

host forms name 3-21,3-24, 5-1 
host name 

MVS 2-14 
VM370RSCS 2-14 
host proc name 
RES LOGON 

SNASBLC 2-38 
host readers 

maximum for SNA 2-45 
host subsystem work sheets 
BSC 

JES2 A-2 
JES3 A-4 
RES A-6 
VM370 RSCS A-8 
SNA 


1ES2 A-ll 
JES3 A-14 
NCPVTAM A-10 
RES A-16 
VSE POWER A-18 
host system 
BSC 

RSCS generation 7-38 
ending the MSRJE connection 3-27 
generation 

SNA JES2 8-5 
SNA JES3 8-22 
SNARES 8-27 
SNA VSE POWER 8-39 
logon attributes 2-15 
name 

SNA 2-33 
number of readers 
BSC 2*23 

signon attributes 2-15 
SNA 

defining MSRJE to 8-1 
host system commands 1-3 
host system configuration for MSRJE 1-9 
host system name 
BSC 2-14 
host system work sheet 
number of punches 
SNA 2-43 

host system work sheets 2-25 

during subsystem configuration 2-7 
filling out 2-2 


I 


IBM 37xx communications controller 7-6,8-3 
indexed file 5-33 

allowing duplicate keys 5-33 
size of key 5-33 
informational messages 
SNA 2-34 

initialization parameters 
JES2 

BSC 7-8 

SNA 8-5 
JES3 

SNA 8-22 

input to MSRJE 1-4,3-9 
installing MSRJE 2-1 
interface 
JES2 

BSC 7-12 
interface type 
RES 

BSC 7-29 

SNA 8-28 
internal forms set table 
BSC 2-19 
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SNA 2-41 


J 


BSC 

starting a printer 7-16 

JES2 

BSC 

&TPBFSIZ 7-10 

&TFIDCT 7-10 

&WAITIME 7-10 

automatic mode, printer 7-14 

automatic mode, punch 7-17 

buffer size 7-8 

card reader definition 7-19 

communications access 7-6 

communications line definition 7-11 

console support 7-12 

disconnect interval 7-12 

forms identifier 7-16 

forms identifier, punch 7-18 

holding reader jobs 7-19 

host subsystem work sheets A-2 

initialization parameters 7-8 

interface 7-12 

LINE macro 7-11 

message class 7-20 

number of buffers 7-8 

number of communications lines 7-9 

number of console message buffers 7-8 

number of host readers 2-23 

number of job output elements 7-9 

number of printers 2-20,7-12 

number of punches 2-20, 7-12 

number of readers 7-13 

number of remote terminals 7-9 

output destination for a reader 7-20 

password, line 7-11 

print translation 7-9 

printer checkpoint 7-15 

printer definition 7-13 

printer output class 7-16 

printer output limit 7-16 

printer page size 7-15 

printer routing code 7-16 

printer separator pages 7-16 

punch checkpoint 7-17 

punch definition 7-17 

punch output class 7-17 

punch output for a reader 7-20 

punch output limit 7-18 

punch routing code 7-18 

reader job class 7-19 

reader priority limit 7-20 

record length 7-12 

Remote Job Entry 7-6 

remote work station definition 7-11 

ROUTECODE 7-13 


routing code 7-13 
selection priority for a reader 7-20 
separator cards 7-18 
separator page line count 7-10 
setup information 7-13 
spool message count 7-10 
starting a punch 7-17 
starting a reader 7-19 
terminal password 7-13 
terminal transparency 7-13 
transmission code 7-11 
transparency 2-23 
transparency, line 7-11 
number of printers 
BSC 2-20 
number of punches 
BSC 2-20 
SIGNON 

BSC 2-16 
SNA 

&NUMBUF 8-6 
&NUMJOES 8-7 
&NUMLNES 8-7 
&NUMRJE 8-7 
&NUMTPBF 8-7 
&PRTRANS 8-8 
&SPOLMSG 8-8 
&TPBFSIZ 8-8 
&TPIDCT 8-8 
&WAI71ME 8-8 
application name 8-5 
APPLID 8-5 

automatic start of printer 8-13 

automatic start of punch 8-17 

buffer size 8-9 

BUFSIZE parameter 8-9 

card control character insertion 8-17 

carriage control character insertion 8-13 

CCTL parameter 8-13 

CCTL parameter, punch 8-17 

checkpoint cards 8-17 

checkpoint pages 8-14 

CKPTLNS parameter 8-14 

CKPTLNS parameter, punch 8-17 

CKPTPGS 8-14 

CKPTPGS parameter, punch 8-17 

communications access 8-4 

compaction 8-14 

compaction, printer 8-18 

compression and expansion 8*9 

compression, printer 8-15 

compression, punch 8-18 

console support 8-10 

default message class for a reader 8-20 

DISCINTV 8-10 

disconnect interval 8-10 

forms identifier 8-15 

forms identifier, punch 8-18 

FORMS parameter 8-15 

FORMS parameter, punch 8-18 

holding input from a reader 8-20 


Index X-9 



host subsystem work sheets A-11 

line definition 8-9 

line password 8-9 

LINEnnn 8-9 

logical unit name 8-10 

LOGON parameter 8-5 

LUNAME parameter 8-10 

maximum number of VTAM sessions 8-6 

MAXSESS 8-6 

NOCCTL parameter 8-13 

NOCCTL parameter, punch 8-17 

number of buffers 8-6 

number of cards 8-17 

number of console messages 8-6 

number of host readers 2-45 

number of job output elements 8-7 

number of lines 8-7 

number of printer 8-11 

number of printers 2-42 

number of punches 2-43,8-11 

number of readers 8-11 

number of RJE terminals 8-7 

number of teleprocessing buffers 8-7 

NUMPR parameter 8-11 

NUMPU parameter 8-11 

NUMRD parameter 8-11 

output calss 8-14 

output class, punch 8-17 

page size 8-14 

PASSWORD parameter 8-11 

PASSWORD, line 8-9 

password, terminal 8-11 

PASSWORD, VTAM 8-5 

print line translation 8-8 

printer destination for a reader 8-21 

printer line width 8-16 

printer logical record length 8-15 

printer output 8-16 

priority level limit 8-21 

punch destination for a reader 8-21 

punch logical record length 8-19 

punch output routing code 8-19 

reader job class 8-20 

reader priority selection 8-21 

record length 8-10 

Remote Job Entry 8-4 

remote printer definition 8-13 

remote printer separator pages 8-8 

remote punch definition 8-17 

remote reader definition 8-20 

remote terminal function interval 8-8 

remote work station definition 8-9 

RMTnn parameter 8-9 

RMTnnn.PRm parameter 8-13 

RMTnnn.RDm parameter 8-20 

Rnnn.PUm parameter 8-17 

separater cards, punch 8-19 

separater pages, printer 8-16 

setup header 8-12 

setup information 8-12 


SETUPHDR parameter 8-12 

SETUPINF parameter 8-12 

spool message count 8-8 

starting a printer 8-15 

starting a punch 8-18 

starting a reader 8-20 

system generation 8-5 

system wide initialization parameters 8-5 

teleprocessing buffer size 8-8 

TERMINAL parameter 8-9 

terminal type 8-9 

unit type 8-9 

VTAM password 8-5 

wait interval 8-12 

WAITIME parameter 8-12 

JES2 LOGON 

SNA 

passwordl parameter 2-37 
password2 parameter 2-37 
RMTnnn parameter 2-37 

JES3 

BSC 7-21 

assigning a terminal to a line 7-24 
buffersize, RJPTERM 7-25 
character compression 7-27 
communications access 7-7 
console authority level 7-22 
console line length 7-22 
console support 7-25 
device defintion 7-23 
dial feature 7-23 
host subsystem work sheets A-4 
line adapter 7-23 
line definition 7-23 
line group 7-23 
line password 7-24 
line speed 7-24 
linename 7-23 

message destination codes 7-21 
number of host readers 2-23 
number of messages 7-22 
number of printers 2-20,7-25 
number of punches 2-20, 7-26 
number of readers 7-26 
operator’s console 7-21 
print width 7-26 
punch record size 7-26 
RJFLINE 7-23 
RJPTERM 7-25 
RTAM 7-7 
starting a line 7-24 
terminal name 7-21 
terminal password 7-27 
terminal type 7-21 
terminal type, RJPTERM 7-25 
transparency 2-23 
transparency, line 7-23 
transparency, terminal 7-25 
work station name, RJPTERM 7-25 

number of printers 
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BSC 2-20 
number of punches 
BSC 2*20 
SNA 2-43 
SIGNON 
BSC 2-17 
SNA 

application name 8-22 
APFLID 8-22 

authority level, CONSOLE parameter 8-24 

automatic logon 8-26 

COMDEFN statement 8-22 

communications access 8-4 

compaction 8-25 

CONSOLE name 8-22 

CONSOLE parameter, authority level 8-24 

CONSOLE parameter, destcode 8-22 

CONSOLE parameter, line length 8-24 

CONSOLE parameter, message classes 8-22 

CONSOLE parameter, TYPE 8-22 

console support 8-22 

device definition 8-24 

DEVICE statement 8-24 

group name, work station 8-25 

host subsystem work sheets A-14 

initialization parameters 8-22 

line length, CONSOLE parameter 8-24 

logical unit name 8-26 

logon attempt limit 8-26 

LU parameter 8-26 

LU statement 8-22 

message buffer size 8-24 

message classes 8-22 

N parameterm RJPWS statement 8-24 

number of host readers 2-45 

number of LU sessions 8-22 

number of printer 8-25 

number of printers 2-42 

number of punches 2-43, 8-25 

number of readers 8-25 

P parameter, RJPWS statement 8-26 

password, terminal 8-26 

PR parameter 8-25 

PU parameter 8-25 

RD parameter 8-25 

remote work station definition 8-24 

RJP name, CONSOLE 8-22 

RJPWS statement 8-24 

RTAM 8-4 

SYSOUT statement 8-26 
system generation 8-22 
VTAM password 8-22 
work station console support 8-25 
work station group name 8-25 
work station name 8-24 
JES3 LOGON 
SNA 

password parameter 2-3 8 
wsname parameter 2-38 
job class, reader 
JES2 


SNA 8-20 

job control language (JCL) 1-3 
job priority 
BSC 2-15 
MSRJE 

SNA 2-34 
valid entries 
BSC 2-15 
SNA 2-34 
job separators 
VSE POWER 
SNA 8-39 
jobclass, reader 
JES2 

BSC 7-19 


K 


keyword 

definition of 4-2 


L 


LDESCR 

RES 

BSC 7-28 
leased line 
RES 

BSC 7-29 

library 

specifying 4-6 

library for procedure, punch output to a data file 5-30 
library for subsystem member 
BSC 2-8 
SNA 2-26 
library name 

ENABLE procedure command 3-2 
LIBRARY utility control statement 4-6 
current library 4-7 
parameters 
name 4-6 
library-name 

MSRJE procedure command 3-4 
line adapter 
JES3 

BSC 7-23 
line definition 
JES2 

SNA 8-9 
JES3 

BSC 7-23 

line description, RTAM 
RES 

BSC 7-28 
line group 
JES3 
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ESC 7-23 
line identifier, RTAM 
RES 

BSC 7-28 

line length console/JES3/BSC 7-22 
line length, CONSOLE parameter 
JES3 

SNA 8-24 
LINE macro 
JES2 

BSC 7-11 
line macro RTAM 
RES 

BSC 7-28 

LINE macro, JES2 BSC 
subparameters 7-11 
EBCDIC 7-11 
HISPEED 7-11 
line speed 7-11 
LOWSPEED 7-11 
NOTRANSP 7-11 
PASSWORD 7-11 
security password 7-11 
transmission code 7-11 
TRANSP 7-11 
transparency 7-11 
line members 
BSC 

associating with a subsystem member 2-11 
SNA 

associated with subsystem member 2-29 
line number 

ENABLE procedure command 3-2 
RES 

BSC 7-29 
line password 
JES2 

SNA 8-9 

line skips for printer output 5-15 
line speed 
JES3 

BSC 7-24 
line speed, RTAM 
RES 

BSC 7-29 

LINEID 

RES 

BSC 7-28 
linename 
JES3 

BSC 7-23 
LINEnnn 
JES2 

SNA 8-9 

lines per inch, printer output 5-14 
lines per page 5-15 


lines per page, printer ouput 5-14 
link identifier 
VM370RSCS 
BSC 7-38 

local forms name 5-12 
local system characteristics 
defining 

SNA 2-25 

logical page size, printer 
JES2 

BSC 7-15 
logical unit name 
JES2 

SNA 8-10 
JES3 

SNA 8-26 
VSE POWER 
SNA 8-40 

LOGMODE parameter 2-37 
logoff, automatic 
RES 

BSC 7-29 
LOGON 
RES 

BSC 2-17 
SNA 2-38 
SNA 2-35 

application ID 2-40 
APPLID parameter 2-37 
DATA parameter 2-37, 2-40 
first 2-35 
format 2-37 
formatted 2-35 
LOGMODE parameter 2-37 
mode name 2-40 
VSE POWER 

SNA 2-39, user information 
logon attempt limit 
JES3 

SNA 8-26 
logon attributes 2-16 
SNA 2-40 
LOGON parameter 
JES2 

SNA 8-5 

LOGON SIGNON text 
BSC 2-16 
LU parameter 
JES3 

SNA 8-26 
LU statement 
IES3 

SNA 8-22 
LUNAME parameter 
JES2 

SNA 8-10 
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M 


MAIL 

RES LOGON 
BSC 2-18 

matching host forms name to table entries 5-1 
maximum number of sessions 
RES 

SNA 8-29 

maximum number of VT AM sessions 
JES2 

SNA 8-6 

member name, subsystem 
BSC 2-8 
SNA 2-26 
message buffer size 
JES3 

SNA 8-24 
message buffers 
RES 

BSC 7-30 
message class 
JES2 

BSC 7-20 
message classes 
JES3 

SNA 8-22 

message destination codes 
JES3 

BSC 7-21 

message destination, CONSOLE parameter 
JES3 

SNA 8-22 

message handling during unattended operation 3-29 

mode name 2-40 

MSRJE 

bind command B-l 
console input 3-10 
Console Input display 3-10 
roll area 3-10 
console priority 2-15 
describing characteristics of 2-7 
disk file utility 6-1 
ending a session 3-26 

ending the connection with the host system 3-27 
examples 

BSC RES C-l 

BSC RES line member configuration 

BSC RES subsystem member configuration C-4 

SNARES C-12 

SNA RES line member configuration C-12 
SNA RES subsystem member 
configuration C-l 7 
first LOGON 2-35 
installing 2-1 
line members 2-2 
number of readers 
BSC 2-22 
output 3-21 
overview 1-1 


phases 4*1 
priority level 
SNA 2-34 

problem determination F-1 
procedure command 

COMMAND parameter 3-5 

CONSOLE parameter 3-7 

D parameter 3-5 

DATA parameter 3-5 

DEL parameter 3-6 

disk file creation date parameter 3-4 

DISK parameter 3-5 

format 3-3 

library-name parameter 3-4 
location parameter 3-4 
NODEL parameter 3-6 
NOREL parameter 3-6 
P parameter 3-5 
PROC parameter 3-5 
read-file-name parameter 3-4 
RELEASE parameter 3-6 
S parameter 3-5 
SOURCE parameter 3-5 
reader input 3-13 
disk 3-18 
display station 3-16 
reader display 3-16 
valid entries from a display station 3-16 
Reader Input display 3-8 
reader termination 3-15, 3-20 
remote location 
disabling 3-28 
SNA 

console priority 2-34 
defining to host system 8-1 
LOGON attributes 2-35,2-40 
number of readers 2-44 
SNA configuration 2-24 
startup display 

MSRJE console 3-7 
status of 3-30 
subsystem member 2-4 
system requirements 1 -7 
system resource security and I -10 
unattended operation 
description 3-29 
message handling 3-29 
termination 3-29 
MSRJE console 

commandkeys 3-12 
MSRJE control table utility 1-8 
MSRJE disk file utility 
introduction to 1-8 
MSRJE example 1-4 
MSRJE procedure 
ending 

effect on 3-7 

MSRJE procedure command 3-3 

MSRJE relationship to SNA Host systems 8-2 

MSRJE utilities 1-8 

MSRJE utility control statements 1-4 
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MULTILEAVING buffer size 
JES2 

BSC 7-8 
multileaving buffers 
RES 

BSC 7-31 

MVS 

host name 2-14 


N 


N parameter, RJPWS statement 
JES3 

SNA 8-24 
namex parameter 
JES3 SIGNON 
BSC 2-17 

naming a remote location 
BSC 2-13 
SNA 2-32 

NCP (Network Control program) 8-3 
NCPVTAM 

SNA host subsystem work sheets A-10 
need for remote job entry 1-1 
nesting 

READFILE statements 4-5 
NOCCTL parameter 
JES2 

SNA 8-13 

NOCCTL parameter, punch 
IES2 

SNA 8-17 
node name 
RES 

SNA 8-29 
NODE parameter 
RES 

SNA 8-29 
NODEL parameter 

MSRJE procedure command 3-6 
NOHALT capability 3-25 
NOREL parameter 

MSR1E procedure command 3-6 
NOSHOW parameter 

ENABLE procedure command 3-2 
NOTICES 

RES LOGON 
BSC 2-17 
number of buffers 
JES2 

BSC 7-8 
SNA 8-6 
RES 

BSC 7-30 
SNA 8-29 
number of cards 
JES2 

SNA 8-17 


number of communications lines 
JES2 

BSC 7-9 

number of console message buffers 
JES2 

BSC 7-8 

number of console messages 
JES2 

SNA 8-6 

number of host readers 
BSC 

IES2 2-23 
JES3 2-23 
RES 2-23 
VM370RSCS 2-23 
JES2 

SNA 2-45 
JES3 

SNA 2-45 
RES 

SNA 2-45 
SNA 2-45 
VSE POWER 
SNA 2-45 

number of job output elements 
JES2 

BSC 7-9 
SNA 8-7 
number of Ikes 
JES2 

SNA 8-7 

number of LU sessions 
JES3 

SNA 8-22 
VSE POWER 
SNA 8-39 
number of messages 
IES3 

BSC 7-22 
number of printers 
BSC 2-20 
JES2 2-20 
JES3 2-20 
RES 2-20 
VM370RSCS 2-20 
JES2 

BSC 7-12 
SNA 8-11 
JES3 

BSC 7-25 
SNA 8-25 
RES 

BSC 7-30 
SNA 8-28 
SNA 2-41 
JES2 2*42 
JESS 2-42 
RES 2-42 
VSE POWER 2-42 
number of printers, total 
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RES 

SNA 8-30 
number of punches 
BSC 2-20 
JES2 2-20 
JES3 2-20 
RES 2-20 
VM370RSCS 2-20 
JES2 

BSC 2-20,7-12 
SNA 8-11 
JES3 

BSC 2-20,7-26 
SNA 2-43,8-25 
RES 

BSC 2-20 
SNA 2-43,8-28 
SNA 

JES2 2-43 
maximum 2-43 
VM370RSCS 
BSC 2-20 
VSE POWER 
SNA 2-43 

number of punches/RES/BSC/ 7-30 
number of punches, total 
RES 

SNA 8-30 
number of readers 
BSC 

host 2-23 
MSRJE 2-22 
JES2 

BSC 7-13 
SNA 8-11 
JES3 

BSC 7-26 
SNA 8-25 
RES 

BSC 7-29 
SNA 8-28 
SNA 

MSRJE 2-44 
number of readers, total 
RES 

SNA 8-29 

number of remote terminals 
JES2 

BSC 7-9 

number of RJE terminals 
JES2 

SNA 8-7 
number of sessions 
minimum 

SNA 2-34 
SNA 2-34 


number of teleprocessing buffers 
JES2 

SNA 8-7 

numnber of blocks, print output to compressed file 5-20 
NUMPR 
JES2 

BSC 7-12 
NUMPR parameter 
JES2 

SNA 8-11 
NUMPU 
JES2 

BSC 7-12 
NUMPU parameter 
JES2 

SNA 8-11 
NUMRD 
JES2 

BSC 7-13 
NUMRD parameter 
JES2 

SNA 8-11 



OCL statements 

running disk file utility with 6-2 
operator messages 
host system 3-25 
MSRJE 3-25 
operator’s console 
JES3 

BSC 7-21 
ouput limit, punch 
JES2 

BSC 7-18 
output calss 
JES2 

SNA 8-14 
output class punch 
JES2 

BSC 7-17 
output class, printer 
JES2 

BSC 7-16 
output class, punch 
JES2 

SNA 8-17 

output destination for a reader 
JES2 

BSC 7-20 

output from MSRJE 1-4,3-21 
overview of MSRJE 1-1 
overview of remote job entry 1-3 
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P parameter 

MSRJE procedure command 3-5 
P parameter, RJPWS statement 
JES3 

SNA 8-26 
page size 
JES2 

SNA 8-14 
parameters 
JES2 

BSC 7-8 
SNA 8-5 
JES2 SIGNON 

pas$word2 2-17 
RMTnnn 2-16 

JES2 SIGNON password 1 2-16 

JES3 

BSC 7-21 
SNA 8-22 
JES3 SIGNON 
namex 2-17 
password 1 2-17 

password2 2-17 
RES LOGON 

password 2-17 
userid 2-17 

RJFILB procedure command 6-2 
RTAM 

BSC 7-29 
SNA 8-28 
SNA 

APPLID 2-37 
DATA 2-37 
LOGMODE 2-37 
MAIL 2-38 
NOTICES 2-38 
password 2-38 
passwordl 2-37 
password2 2-37 
PROC (procname) 2-38 
remid 2-39 
RMTnnn 2-37 
TERM(termid) 2-38 
userid 2-38 
wsname 2-38 
VM370 RSCS SIGNON 
password 2-18 
REMOTEnn 2-18 
password 

VM370 RSCS 
BSC 7-41 
VSE POWER 
SNA 8-39 
password parameter 
JES2 

SNA 8-11 
RES LOGON 


BSC 2-17 

VM370 RSCS SIGNON 
BSC 2-18 
password, level 
JES2 

BSC 7-11 
password, line 
JES2 

SNA 8-9 
JES3 

BSC 7-24 

password, RTAM macro 
RES 

SNA 8-30 

password, terminal 
IES2 

BSC 7-13 
SNA 8-11 
JES3 

BSC 7-27 
SNA 8-26 
PASSWORD, VTAM 
JES2 

SNA 8-5 

passwordl parameter 
JES2 SIGNON 
BSC 2-16 
JES3 SIGNON 
BSC 2-17 
password2 parameter 
JES2 SIGNON 
BSC 2-17 
JES3 SIGNON 
BSC 2-17 
PCHS parameter 
RES 

SNA 8-28 

pended DISABLE 3-28 
PEP 8-3 
permanent logon 
RES 

SNA 8-29 
PLGN parameter 
RES 

SNA 8-29 
POWER macro 
VSE POWER 
SNA 8-39 
PR parameter 
JES3 

SNA 8-25 
preferred disk location 
compressed disk output 
print 5-20 
punch 5-35 
Control Table menu 5-7 
punch output to a disk file 5-32 
preferred file location, punch output to a data file 5-32 
preferred location, print output to compressed file 5-20 
preferred location, punch output to compressed file 5-35 
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print default entry 5-29 
when used 5-2 

print default entry, forms control table D-l 
print file sequence number 5-19 
print output 3-22 
print line translation 
JES2 

SNA 8-8 
print output 

compressed disk file 3 -22 

label 3-22 

print file sequence number 3-22 
default destination 3-21 
destination 3-21 
unprocessed records 3-22 

label 3-22 

print file sequnce number 3-22 
print output to compressed file 5-19 
adding to exsting file 5-21 
error save 5-20 
extending a file 5-20 
file extendability 5-20 
file location 5-20 
file name 5-19 
file name examples 5-19 
file size 5-20 
freeing unused space 5-21 
number of blocks 5-20 
preferred location 5-20 
printer definition 5-22 
resource security 5-20 
saving the file 5-20 
user ID 5-20 
print style 

control table utility 5-13 
print translation 
JES2 

BSC 7-9 
print width 
JES3 

BSC 7-26 
RES 

BSC 7-29 
printer attributes 
BSC 2-19 
SNA 2-41 
printer automatic mode 
JES2 

BSC 7-14 
printer checkpoint 
1ES2 

BSC 7-15 

printer data streams 1 -3 
printer definition 
JES2 

BSC 7-13 

printer definition, print output to compressed file 5-22 
printer destination for a reader 
JES2 

SNA 8-21 

printer file sequence number 


BSC 2-20 
SNA 2-42 
printer line length 
JES2 

SNA 8-16 
printer logical page size 
JES2 

BSC 7-15 

printer logical record length 
JES2 

SNA 8-15 
printer output 

align forms 5-13 
carriage control characters 5-15 
characters per inch 5-14 
formatting output 5-14 
line skips 5-15 
hues per inch 5-14 
lines per page 5-14, 5-15 
local forms name 5-12 
selecting the printer 5-12 
spooled display 5-15 
spooling 5-13 
printer output class 
JES2 

BSC 7-16 
printer output limit 
JES2 

BSC 7-16 

printer output routing code 
JES2 

SNA 8-16 
printer routing code 
JES2 

BSC 7-16 
printer separator pages 
JES2 

BSC 7-16 
printer, starting 
JES2 

BSC 7-16 

printers 

maximum for BSC 2-20 
priority level limit 
JES2 

SNA 8-21 
priority levels 2-15 
priority limit for a reader 
JES2 

BSC 7-20 

problem determination F-l 
PROC parameter 

MSRJE procedure command 3-5 
PROC(procname) 

RES LOGON 

BSC 2-17 
procedure commands 
RJFILE 6-2 

procedure library, punch output to a data file 5-30 
procedure name, punch output to a data file 5-30 
program products definition 2-1 
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PSWRD parameter 
VSE POWER 

SNA 8-40 
PTRS parameter 
RES 

SNA 8-28 
PU parameter 
JES3 

SNA 8-25 
punch attributes 
BSC 2-19 
SNA 2-41 
punch checkpoint 
JES2 

BSC 7-17 
punch data 

destination of 3-23 
to user defined file 5-4 
punch data streams 1-3 
punch default entry, forms control table D-4 
punch definition 
JES2 

BSC 7-17 

punch destination for a reader 
JES2 

SNA 8-21 

punch file sequence number 5-34,5-37 
BSC 2-21 
disk file 3-24 \ 

punch output 3-24 \ 

SNA 2-43 
punch logical page size 
JES2 

BSC 7-17 

punch logical record length 
JES2 

SNA 8-19 
punch output 

compressed disk file 

punch file sequence number 3-24 
default destination 3-24 
defining 5-4 
to compressed file 5-5 
to indexed file 5-5 
unprocessed records 

punch file sequnce number 3-24 
punch output for a reader 
JES2 

BSC 7-20 
punch output limit 
JES2 

BSC 7-18 

punch output routing code 
JES2 

SNA 8-19 

punch output to a compressed file 5-34 
punch output to a data file 
add to existing file 5-31 
delete capable file 5-32 
extending the file 5-32 


fifes extendability 5-32 
file location 5-32 
file name 5-30 
file size 5-32 
file type 5-31 
freeing unused space 5-31 
indexed file 5-33 
library for procedure 5-30 
preferred file location 5-32 
procedure library 5-30 
procedure name 5-30 
record length 5-32 
resource security 5-30 
save on error 5-31 
user ID 5-30 

punch output to a disk file 5-30 
indexed file 

start of key 5-33 
punch output to compressed file 
error save 5-35 
extending the file 5-35 
file extendability 5-35 
file location 5-35 
file name 5-34 
file name example 5-34 
file size 5-35 
freeing disk space 5-36 
preferred location 5-35 
resource security 5-35 
saving the file 5-35 
user ID 5-35 
punch record size 
JES3 

BSC 7-26 
punch routing code 
JES2 

BSC 7-18 
punch, starting 
JES2 

BSC 7-17 


R 


RD parameter 
JES3 

SNA 8-25 
RDRS parameter 
RES 

SNA 8-28 
read-file-name 

MSRJE procedure command 3-4 
reader attributes 
- BSC ‘ 2-22 
SNA 2-44 
reader input 

utility control statements 4-1 
reader priority selection 
JES2 
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SNA 8-21 
reader route code 
JES2 

BSC 7*20 

READFILE in progress display 3-19 
ATTN key 3*19 
command keys 3-19 
READFILE utility control statement 4-3 
as console input 3-11 
format 4-3 
parameters 
date 4-3 
library 4-3 
name 4-3 
type 4-3 

READFILE utility control statements 
nesting of 4-5 
record length 
JES2 

BSC 7-12 
SNA 8-10 

record length, punch output to a data file 5-32 
record size 

disk input 3-20 
RELEASE parameter 

MSRJE procedure command 3-6 
remote job entry 1-1 
remote location 
activating 

SNA 2-32 
BSC 

activating 2-13 
naming 

BSC 2-13 
SNA 2-32 
SNA 

definition 2*32 
remote location name 

ENABLE procedure command 3-2 
MSRJE procedure command 3-4 
remote printer definition 
JES2 

SNA 8-13 

remote printer separator pages 
JES2 

SNA 8-8 

remote punch definition 
JES2 

SNA 8-17 

remote reader definition 
JES2 

SNA 8-20 
remote system 
selecting 

BSC 2*12 
SNA 2-30 

remote terminal function interval 
JES2 

BSC 7-10 
SNA 8*8 

remote work station definition 


JES2 

BSC 7-11 
SNA 8-9 
JES3 

SNA 8*24 
REMOTEnn parameter 
VM370 RSCS SIGNON 
BSC 2-18 

remove a subsystem member 
BSC 2-8 
SNA 2-26 

requirements for MSRJE 1-7 
RES 
BSC 

automatic logoff 7-29 
buffer size 7-30 
console suport 7-29 
example C-l 
generation 7-28 
generation example 7-32 
host subsystem work sheets A-6 
interface type 7-29 
leased line 7-29 
line description, RTAM 7-28 
line identifier, RTAM 7-28 
line macro, RTAM 7-28 
line member configuration example C 
line number 7-29 
line speed 7*29 
message buffers 7-30 
multileaving buffers 7-31 
number of buffers 7-30 
number of host readers 2-23 
number of printers 2-20, 7-30, 7-31 
number of punches 2-20, 7*30 
number of readers 7-29 
print width 7-29 
RTAM generation 7-28 
RTAM macro 7-30 
system generation requirements 7-28 
terminal description 7-29 
terminal identifier 7-29 
TERMINAL macro 7-29 
terminal type 7-29 
timeout value 7-30 
total number of punches 7-31 
total number of readers 7-31 
transmission code 7-30 
transparency 2-23,7 -29 
LOGON 

BSC 2-17 
number of printers 
BSC 2*20 
number of punches 
BSC 2*20 
SNA 2-43 
SNA 

application ID, RTAM macro 8-30 
APPLID, RTAM macro 8*30 
buffer size 8*29 
BUFXSIZ parameter 8-29 


1, C-4 
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CNMSGNO 8-29 
compaction, RTAM macro 8-30 
compression, RTAM macro 8-30 
CONPR parameter 8-29 
console message buffers 8-29 
console printer 8-29 
console support 8-28 
example C-12 
generation example 8-31 
generation requirements 8-27 
host subsystem work sheets A-16 
interface type 8-28 

line member configuration example €-12 

maximum number of sessions 8-29 

NODE parameter 8-29 

number of buffers 8-29 

number of host readers 2-45 

number of printer 8-28 

number of printers 2-42 

number of printers, total 8-30 

number of punches 2-43,8-28 

number of punches, total 8-30 

number of readers 8-28 

number of readers, total 8-29 

password, RTAM macro 8-30 

PCHS parameter 8-28 

permanent logon 8-29 

PLGN parameter 8-29 

PTRS parameter 8-28 

RDRS parameter 8-28 

RTAM 8-27 

RTAM generation 8-28 

RTAM macro 8-29 

SESSLIM parameter 8-29 

stages 8-27 

subsystem member configuration example C-17 

system generation 8-27 

TDESCR parameter, TERMINAL macro 8-28 

TERMID parameter, TERMINAL macro 8-28 

terminal description, TERMINAL macro 8-28 

TERMINAL macro 8-28 

terminal number, TERMINAL macro 8-28 

terminal print width 8-28 

terminal type 8-28 

total number of printers, RTAM macro 8-30 
total number of punches, RTAM macro 8-30 
total number of readers, RTAM macro 8-29 
transparency 8-28 
VS1 requirements 8-27 
RES LOGON 
MAIL 2-18 
NOTICES 2-17 
PROC (procname) 2-17 
SNA 

catalogued procedure name 2-38 
general messages 2-38 
general notices 2-38 
MAIL parameter 2-38 
NOTICES parameter 2-38 
password parameter 2-38 


PROC(procname) 2-38 
TERM(termid) 2-38 
userid 2-38 
TERM(termid) 2-17 
RES/BSC/eonsole output/ 7-30 
resource security, print output to compressed file 5-20 
resource security, punch output to a data file 5-30 
resource security, punch output to compressed file 5-35 
review a subsystem member 
SNA 2-26 

reviewing a subsystem member 
BSC 2-8 
RJE overview 1-3 
RJE terms 1-3 
RJFILE 

description 6-1 
procedure command 6-2 
RJPLINE 
JES3 

BSC 7-23 
RJPTERM 
JES3 

BSC 7-25 
RJPWS statement 
1ES3 

SNA 8-24 

RJTABLE procedure command 5-1, 5-6 
RMT macro, JES2 BSC 
subparameters 7-11 
CONSOLE 7-12 
console support 7-12 
data record length 7-12 
DISCINTV 7-12 
disconnect interval 7-12 
FIXED 7-12 
HARDWARE 7-12 
MULTI 7-12 
NOCON 7-12 
NOTRANSP 7-13 
number of printers 7-12 
number of punches 7-12 
number of readers 7-13 
NUMPR 7-12 
NUMPU 7-12 
NUMRD 7-13 
PASSWORD 7-13 
ROUTECDE 7-13 
routing code 7-13 
security password 7-13 
set up messages 7-13 
SETUPACT 7-13 
SETUPINF 7-13 
TRANSP 7-13 
transparency 7-13 
VARIABLE 7-12 
RMTnn parameter 
JES2 

SNA 8-9 
RMTnnn parameter 
JES2 SIGNON 
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BSC 2-16 

RMTnnn.PRm parameter 
JES2 

SNA 8-13 

RMTnnn.RDm parameter 
JES2 

SNA 8-20 
Rnnn.PUm parameter 
JES2 

SNA 8-17 
route code 
JES2 

BSC 7-20 
ROUTECODE 
JES2 

BSC 7-13 
routing code 
JES2 

BSC 7-13 
routing code, printer 
JES2 

BSC 7-16 
routing code, punch 
JES2 

BSC 7-18 
routing code, terminal 
JES2 

SNA 8-11 

RSCS 

BSC 

host system generation 7-38 
number of printers 2-20 
generation 
BSC 7-38 
SIGNON 

BSC 2-18 

RTAM 

BSC 

communications access 7-6 
macroinstructions 7-28 
parameters 7-29 
stage 1 7-28 

stage 2 7-31 
JES3 7-7 
SNA 

communications access 8-4 
JES3 8-4 

macroinstructions 8-28 
parameters 8-28 
RES 8-27 
stage 1 8-28 

stage 2 8-29 

RTAM (remote terminal access method 8-3 
RTAM generation 
RES 

SNA 8-28 
RTAM macro 
RES 

BSC 7-30 
SNA 8-29 
rules for coding 


utility control statements 4-2 


s 


S parameter 

MSRJE procedure command 3-5 
save if error, punch output to a data file 5-31 
saving the file, print output to compressed file 5-20 
saving the file, punch output to compressed file 5-35 
selecting remote system 
BSC 2-12 
SNA 2-30 

selecting the printer 5-12 
selecting the subsystem member 2-29 
BSC 2-11 

selection priority for a reader 
JES2 

BSC 7-20 

sending first LOGON 2-3 5 
separator page line count 
JES2 

BSC 7-10 
separator pages 
VSE POWER 
SNA 8-39 
separtor cards 
JES2 

BSC 7-18 

sepearator cards, punch 
JES2 

SNA 8-19 

sepearator pages, printer 
JES2 

SNA 8-16 
sequence number 
BSC 

printer file 2-20 
punch file 2-21 
printer file 

SNA 2-42 
SNA 

punch file 2-43 
session 1-3 
session limit 

VSE POWER 
SNA 8-40 
sessions, maximum 
SNA 2-34 
sessions, minimum 
SNA 2-34 
SESSLIM parameter 
RES 

SNA 8*29 

SETFORM utility control statement 4-11 
format 4-11 
parameters 

forms name 4-11 
PRn 4-11 
PUn 4-11 
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setup header 
JES2 

SNA 8-12 
setup information 
JES2 

BSC 7-13 
SNA 8-12 
SETUPACT 
JES2 

BSC 7-13 

SETUPHDR parameter 
JES2 

SNA 8-12 
SETUPINF 
JES2 

BSC 7-13 
SETUPINF parameter 
JES2 

SNA 8-12 
SHOW parameter 

ENABLE procedure command 3-2 
signing a display station off MSRJE 3-26 
SIGNON 
JES2 

BSC 2-16 
JES3 

BSC 2-17 
VM370 RSCS 
BSC 2-18 

signon attributes 2-16 
SIGNON LOGON text 
BSC 2-16 
SML 7-7 
SMI 

VM370 RSCS 
BSC 7-38 

SNA 

changing a subsystem member 2-26 
changing remote location 2-30 
CMD default 2-46 
communications access methods 
JES2 8-4 
JES3 8-4 
RTAM 8-4 

communications controller 8-3 

creating a new subsystem member 2-26 

creating a subsystem member from existing 2-26 

defining a subsystem member 2-27 

defining remote location 2-30 

DEL default 2-46 

deleting a subsystem member 2-26 

editing a subsystem member 2-26 

editing remote location 2-30 

ending subsystem member definition 2-46 

existing library name 2-27 

existing member name 2-27 

formatted LOGON 2-35 

forms control table name 2-41 

forms set 2-41 

host subsystem work sheets A-10 


host system 

defining MSRJE to 8-1 
host system name 2-33 
host systems supported by MSRJE 1-6 
informational messages 2-34 
JES2 

communications access 8-4 
generation 8-5 

host subsystem work sheets A-11 
initialization parameters 8-5 
number of host readers 2-45 
number of printers 2-42 
number of punches 2-43 
JES2 LOGON 

passwordl 2-37 
password2 2-37 
RMTnnn 2-37 
JES3 

communications access 8-4 
generation 8-22 
host subsystem work sheets A-14 
initialization parameters 8-22 
number of host readers 2-45 
number of printers 2-42 
number of punches 2-43 
JES3 LOGON 
password 2-38 
wsname 2-38 

library for subsystem member 2-26 

location name 2-30 

LOGON 

application ID 2-40 
APPLID parameter 2-37 
attributes 2-35 
data 2-40 

DATA parameter 2-37 
format 2-37 
formatted 2-35 
LOGMODE parameter 2-37 
mode name 2-40 
LOGON attributes 2-40 
member type 2-28 
naming the remote location 2-32 
NCP VTAM 

host subsystem work sheets A-10 
number of host readers 2-45 
number of MSRJE readers 2-44 
number of printers 2-41 
number of punches 
maximum 2-43 
number of sessions 2-34 
printer file sequence number 2-42 
priority level 2-34 
punch attributes 2-41 
punch file sequence number 2-43 
reader attributes 2-44 
remote location 
activating 2-32 
definition 2-32 
name 2-32 
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remote system 

selecting 2-30 
remote system name 2-30 
removing remote location 2-30 
RES 

example C-12 

generation 8-27 

generation example 8-31 

host subsystem work sheets A-16 

line member configuration example 012 

number of host readers 2-45 

number of printers 2-42 

number of punches 2-43 

RTAM 8-27 

subsystem member configuration example 017 
RESLOGON 
MAIL 2-38 
NOTICES 2*38 
PROC (procname) 2-38 
TERM(termid) 2-38 
userid 2-38 

reviewing a subsystem member 2-26 
reviewing remote location 2-30 
RTAM 

communications access 8-4 
macroinstructions 8-28 
parameters 8-28 
stage 1 8-28 

stage 2 8-29 

selecting remote system 2-30 
selecting the subsystem member 2-29 
stage 1 of RTAM generation 8-28 
stage 2 of RTAM generation 8-29 
subsystem member 

associated line member 2-29 
subsystem member attributes 2-33 
subsystem member definition 2-25 
subsystem member name 2-26 
subsystem member selection 2-29 
sybsystem type 2-29 
termination delay 2-33 
transparency 2-45 
TYPE default 2-45 
VSE POWER 

generation 8-39 
host subsystem work sheets A-18 
number of host readers 2-45 
number of printers 2-42 
number of punches 2-43 
user information 2-39 
VSE POWER LOGON 
remid 2-39 

3705-11 generation example 8-34 
SNA host systems relationships to MSRJE 8-2 
SNA printer attributes 2-41 
SNA Upline Facility 

sharing a line with MSRJE 1-6 
SNUF 1-6 

SNA 3270 device emulation 

sharing a line with MSRJE 1 -6 
solving problems F-l 


SOURCE parameter 

MSRJE procedure command 3-5 
specify member type 
BSC 2-10 
SNA 2*28 

specifying subsystem type 
BSC 2-11 

specifying the host system name 
BSC 2-14 
SNA 2-33 

specifying the LOGON or SIGNON 
BSC 2-16 
spool file 

job name 3-22 
spool message count 
JES2 

SNA 8-8 

spool message record count 
JES2 BSC 7-10 
spool multileaving line driver 7-7 
see SMI 7-38 
spooled output 5-15 

hold after printing 5-16 
number of copies 5-16 
print after job step ends 5-16 
spool file activity 5-17 
spool file priority 5-17 
spooled printer output 5-13 
stage 1 of RTAM generation 
BSC 7-28 
SNA 8-28 

stage 2 of RTAM generation 
BSC 7-31 
SNA 8-29 
staring a punch 
JES2 

BSC 7-17 
starting a line 
JES3 

BSC 7-24 
starting a printer 
JES2 

BSC 7-16 

SNA 8-15 
starting a punch 
JES2 

SNA 8-18 
starting a reader 
JES2 

BSC 7-19 

SNA 8-20 

starting an MSRJE session 3-3 
starting the CNFIGICF procedure 2-2 
starting the control table utility 5-6 
statement identifiers 4-2 
status of MSRJE 3-30 
subsystem definition 
BSC 2-7 

example 2-7 
example 

BSC 2-7 
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SNA 2*25 

subsystem member 2*4 
ESC 

associating with a line member 2*11 
changing 2*8 
creating 2*8 
creating from existing 2*8 
defining attributes 2-14 
deleting 2-8 
reviewing 2-8 
selecting type of 2-11 
selection 2-11 
viewing 2-8 
changing 
BSC 2-8 
SNA 2-26 
defining 2-27 
selecting 

SNA 2-29 
SNA 

attributes 2-33 
definition 2-25 
viewing 

BSC 2-8 

subsystem member definition 
SNA 

ending 2-46 
subsystem member name 
BSC 2-8 

ENABLE procedure 3-1 
SNA 2-26 
subsystem operation 
SNA 2-26 
subsystem type 
SNA 2-29 
supported host systems 
BSC 7-1 
SNA 8-1 
SYSOUT statement 
JES3 

SNA 8-26 

system configuration 2-1 
system generation 
JES2 

SNA 8-5 
JES3 

SNA 8-22 
VSE POWER 
SNA 8-39 
system wide parameters 
JES2 

SNA 8-5 

System/36 MSRJE 1-4 


T 


table name 

control table utility 
defining 5-7 

TDESCR parameter, TERMINAL macro 
RES 

SNA 8-28 

teleprocessing buffer size 
JES2 

BSC 7-10 
SNA 8-8 
TERM(termid) 

RES LOGON 
BSC 2-17 

TERMID parameter, TERMINAL macro 
RES 

SNA 8-28 

terminal characteristics, PRMT macro 
VSE POWER 
SNA 8-40 
terminal definitions 
JES3 

BSC 7-25 
terminal description 
RES 

BSC 7-29 

terminal description, TERMINAL macro 
RES 

SNA 8-28 

terminal identification number 
VSE POWER 
SNA 8-40 
terminal identifier 
RES 

BSC 7-29 
TERMINAL macro 
RES 

BSC 7-29 
SNA 8-28 
terminal name 
JES3 

BSC 7-21 

terminal number, TERMINAL macro 
RES 

SNA 8-28 
TERMINAL parameter 
JES2 

SNA 8-9 
terminal password 
VSE POWER 
SNA 8-40 
terminal print width 
RES 

SNA 8-28 
terminal routing code 
JES2 

SNA 8-11 
terminal type 
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JES2 

SNA 8-9 
IES3 

BSC 7-21 
RES 

BSC 7-29 

SNA 8-28 
VSE POWER 

SNA 8-40 

terminal type, RJPTERM 
JES3 

BSC 7-25 

terminating and MSRJE reader 3-15 

terminating MSRJE during unattended operation 3-29 

termination 

MSRJE connection to the host 3-27 
MSRJE reader 3-20 
termination delay 
specifying 4-13 
termination delay time 
BSC 2-15 
SNA 2-33 

terms used by RJE 1-3 
text transparency 
BSC 2-23 
SNA 2-45 
timeout value 
RES 

BSC 7-30 

total number of printers 
RES 

BSC 7-31 

total number of printers, RTAM macro 
RES 

SNA 8-30 

total number of punches 
RES 

BSC 7-31 

total number of punches, RTAM macro 
RES 

SNA 8-30 
total number of readers 
RES 

BSC 7-31 

total number of readers, RTAM macro 
RES 

SNA 8-29 

traditional computer input l-l 
transmission code 
JES2 

BSC 7-11 
RES 

BSC 7-30 
transparency 
JES2 

BSC 2-23 
JES3 

BSC 2-23 
RES 

BSC 2-23,7-29 

SNA 8-28 


VM370 RSCS 

BSC 2-23 
transparency, line 
JES2 

BSC 7-11 
JES3 

BSC 7-23 
transparency, RTAM 
RES 

BSC 7-29 
transparency, terminal 
JES2 

BSC 7-13 
JES3 

BSC 7-25 
transparent text mode 
BSC 2-23 
SNA 2-45 
TYPE 
SNA 

default 2-45 
TYPE default 2-24 
TYPE, CONSOLE parameter 
JES3 

SNA 8-22 



unattended operation 3-29 
unit type 
JES2 

SNA 8-9 
unprocessed records 
print output 3-22 
updating a print default entry 5-29 
user ID, print output to compressed file 5 
user ID, punch output to a data file 5-30 
user ID* punch output to compressed file 
userid parameter 
RES LOGON 
BSC 2-17 

utility control statements 
CANCEL 4-9 
comments in 4-2 
console input 4-1 
END 4-13 
EOF 4-8 

keyword definition 4-2 
LIBRARY 4-6 
MSRJE 4-1 
parameters 

READFILE 4-3 
reader input 4-1 
READFILE 4-3 
SETFORM 4-11 
statement identifiers 4-2 
utility control statments 
rules for coding 4-2 
utilty control statments 


-20 

5-35 
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format 4-2 


V 


view configuration values 

ENABLE procedure command 3-2 
view subsystem member 
SNA 2-26 

viewing a subsystem member 
BSC 2-8 

virtual machine attributes 
VM370RSCS 
BSC 7-38 
virtual machine paths 
VM370 RSCS 
BSC 7-38 

VM370 

RSCS 

BSC buffer size 
VM370 RSCS 
BSC 

communications access 7-7 
file class 7-38 

host subsystem work sheets A-8 
link identifier 7-38 
number of host readers 2-23 
number of printers 2-20 
number of punches 2-20 
password 7-41 
transparency 2-23 
virtual machine attributes 7-38 
virtual machine path 7-38 
work station definition 7-38 
work station number 7-40 
number of punches 
BSC 2-20 
SIGNON 
BSC 2-18 

VM370 RSCS generation 
BSC 7-38 
VM370 RSC1 

host name 2-14 
VSE POWER 
LOGON 

SNA 2-39 
number of punches 
SNA 2-43 
SNA 

application ID 8-39 

console support 8-40 

data block size 8-39 

host subsystem work sheets A-l 8 

job separators 8-39 

logical unit name 8-40 

number of host readers 2-45 


number of LU sessions 8-39 
number of printers 2-42 
number of punches 2-43 
password 8-39 
POWER macro 8-39 
separator pages 8-39 
session limit 8-40 
system generation 8-39 
terminal characteristics, PRMT macro 
terminal identification number 8-40 
terminal password 8-40 
terminal type 8-40 
VSE POWER LOGON 
SNA 

user information 2-39 
VS1 8-27 
VTAM password 
JES2 

SNA 8-5 
JES3 

SNA 8-22 


w 


wait interval 
JES2 

SNA 8-12 
WAITIME parameter 
JES2 

SNA 8-12 
work sheets 

host subsystem 

BSC A-2 

SNA A-10 
host system 2-25 
work sheets* host system 
filling out 2-2 
work station console support 
JES3 

SNA 8-25 
work station definition 
VM370 RSCS 

BSC 7-38 

work station group name 
JES3 

SNA 8-25 
work station name 
JES3 

SNA 8-24 

work station name, RJPTERM 
JES3 

BSC 7-25 
work station number 
VM370 RSCS 

BSC 7-40 


8-40 
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Numerics 


37xx communications controller 7-6, 8-3 
3705 NCP 

PEP generation 7-34 




X-28 Multiple Session Remote Job Entry Guide 



System/36: 

Multiple Session Remote Job Entry Guide 


SC21-7909-2 


READER'S COMMENT FORM 


Please use this form only to identify publication errors or to request changes in publications. Direct any 
requests for additional publications, technical questions about IBM systems, changes in IBM programming support, and 
so on, to your IBM representative or to your nearest IBM branch office. You may use this form to communicate your 
comments about this publication, its organization, or subject matter, with the understanding that IBM may use or 
distribute whatever information you supply in any way it believes appropriate without incurring any obligation to you. 


□ If your comment does not need a reply (for example, pointing out a typing error) check this box and do not 
include your name and address below. If your comment is applicable, we will include it in the next revision 
of the manual. 


□ If you would like a reply, check this box. Be sure to print your name and address below. 


Page number(s): 


Comment(s): 


Please contact your nearest IBM branch office to request additional 
publications. 



Name 





Company or 
Organization 





Address 




No postage necessary if mailed in the U.S.A. 





Phone No. 

City 

( ) 

State 

Zip Code 



Area Code 



Fold and tape. Please do not staple. 


NO POSTAGE 
NECESSARY 
IF MAILED IN THE 
UNITED STATES 


BUSINESS REPLY MAIL 


FIRST CLASS / PERMIT NO. 40 / ARMONK, NEW YORK 


POSTAGE WILL BE PAID BY ADDRESSEE 

International Business Machines Corporation 

Information Development 
Department 245 

Rochester, Minnesota, U.S.A. 55901 


Fold and tape. Please do not staple. 


-J 



r? 


Cut Along Line Cut Along Line 



System/36: 

Multiple Session Remote Job Entry Guide 


SC21-7909-2 


What Is Your Opinion of This Manual? 

Your comments can help us produce better manuals. Please take a few minutes to evaluate this manual as soon as you become 
familiar with it. Circle Y (Yes) or N (No) for each question that applies. IBM may use or distribute whatever information you supply in 
any way it believes appropriate without incurring any obligation to you. 


FINDING INFORMATION 

Y N Is the table of contents helpful? 

What would make it more helpful? 


USING INFORMATION 

Y N Does the information apply to your situation? 
Which topics do not apply? 


Y N Is the index complete? 

List specific terms that are missing. 


Y N Is the information accurate? 

What information is inaccurate? 


Y N Are the chapter titles and other headings meaningful? 
What would make them more meaningful? 


Y N Is the information complete? 

What information is missing? 


Y N Is information organized appropriately? 

What would improve the organization? 


Y N Is only necessary information included? 

What information is unnecessary? 


Y N Does the manual refer you to the appropriate places 
for more information? 

List specific references that are wrong or 
missing. 


UNDERSTANDING INFORMATION 

Y N Is the purpose of this manual clear? 

What would make it clearer? 


Y N Are the examples useful models? 

What would make them more useful? 


Y N Is the format of the manual (shape, size, color) 
effective? 

What would make the format more effective? 


OTHER COMMENTS 


Y N Is the information explained clearly? 
Which topics are unclear? 


Use the space below for any other opinions about this manual 
or about the entire set of manuals for this system. 


Y N Are the examples clear? 

Which examples are unclear? 


Y N Are examples provided where they are needed? 

Where should examples be added or deleted? 


Y N Are terms defined clearly? 

Which terms are unclear? 


Y N Are terms used consistently? 

Which terms are inconsistent? 


YOUR BACKGROUND 

What is your job title? 

What is your primary job responsibility? 

How many years have you used computers? 

Which programming languages do you use? 

How many times per month do you use this manual? 


Y N Are abbreviations and acronyms understandable? 
Which ones are not understandable? 


Y N Are the illustrations clear? 

Which ones are unclear? 


Your name _ 

Company name ___ 

Street address _ 

City, State, ZIP __ 

Phone No. ( _)_ 

Area Code 
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